原文： http://zetcode.com/gui/winapi/controls/

控件是 Windows 应用的基本构建块。 （控件在 UNIX 中称为小部件。）Windows API 教程的这一部分涵盖了静态控件，按钮，复选框和编辑框。

控件也是窗口。 它们是使用CreateWindowW()或CreateWindowExW()函数创建的。 这些函数分别将窗口类名称作为其第一个和第二个参数。 控件具有其特定的预定义窗口类名称； 因此，在创建控件时，我们不会调用RegisterClassW()或RegisterClassExW()。

静态控件

静态控件显示文本和图形。 无法选择静态控件。 它还不能具有键盘焦点。

静态文字

在第一个示例中，我们创建一个静态文本控件。

static_text.c

  1. #include <windows.h>
  3. LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  5. int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
  6.                     PWSTR lpCmdLine, int nCmdShow) {
  8.     MSG  msg;    
  9.     WNDCLASSW wc = {0};
  10.     wc.lpszClassName = L"Static Control";
  11.     wc.hInstance     = hInstance;
  12.     wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
  13.     wc.lpfnWndProc   = WndProc;
  14.     wc.hCursor       = LoadCursor(0, IDC_ARROW);
  16.     RegisterClassW(&wc);
  17.     CreateWindowW(wc.lpszClassName, L"Criminal",
  18.                   WS_OVERLAPPEDWINDOW | WS_VISIBLE,
  19.                   100, 100, 330, 270, 0, 0, hInstance, 0);
  21.     while (GetMessage(&msg, NULL, 0, 0)) {
  23.         TranslateMessage(&msg);
  24.         DispatchMessage(&msg);
  25.     }
  27.     return (int) msg.wParam;
  28. }
  30. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
  31.     WPARAM wParam, LPARAM lParam) {
  33.     static wchar_t *lyrics =  L"I know you told me I should stay away\n\
  34. I know you said he's just a dog astray\n\
  35. He is a bad boy with a tainted heart\n\
  36. And even I know this ain't smart\n\
  37. \n\
  38. But mama, I'm in love with a criminal\n\
  39. And this type of love isn't rational, it's physical\n\
  40. Mama, please don't cry, I will be alright\n\
  41. All reason aside, I just can't deny, love the guy\n\
  42. ";
  44.     switch(msg) {
  46.         case WM_CREATE:
  48.             CreateWindowW(L"Static", lyrics, 
  49.                 WS_CHILD | WS_VISIBLE | SS_LEFT,
  50.                 20, 20, 300, 230, 
  51.                 hwnd, (HMENU) 1, NULL, NULL);
  52.             break;
  54.         case WM_DESTROY:
  56.             PostQuitMessage(0);
  57.             break;
  58.     }
  60.     return DefWindowProcW(hwnd, msg, wParam, lParam);
  61. }

该示例在窗口上显示歌曲的歌词。

  1. CreateWindowW(L"Static", lyrics, 
  2.     WS_CHILD | WS_VISIBLE | SS_LEFT,
  3.     20, 20, 300, 230,
  4.     hwnd, (HMENU) 1, NULL, NULL);
  5. break;

静态控件是使用L"Static"类创建的。 文本以SS_LEFT样式向左对齐。

Windows API 控件 I - 图1

Static text control

静态图像

第二个示例创建一个静态图像控件。

static_image.c

  1. #include <windows.h>
  3. LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  4. void LoadMyImage(void);
  6. HBITMAP hBitmap;
  8. int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
  9.                     PWSTR lpCmdLine, int nCmdShow) {
  11.     MSG  msg;    
  12.     WNDCLASSW wc = {0};
  13.     wc.lpszClassName = L"Static image";
  14.     wc.hInstance     = hInstance;
  15.     wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
  16.     wc.lpfnWndProc   = WndProc;
  17.     wc.hCursor       = LoadCursor(0,IDC_ARROW);
  19.     RegisterClassW(&wc);
  20.     CreateWindowW(wc.lpszClassName, L"Static image",
  21.                   WS_OVERLAPPEDWINDOW | WS_VISIBLE,
  22.                   100, 100, 330, 270, 0, 0, hInstance, 0);
  24.     while (GetMessage(&msg, NULL, 0, 0)) {
  26.         TranslateMessage(&msg);
  27.         DispatchMessage(&msg);
  28.     }
  30.   return (int) msg.wParam;
  31. }
  33. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
  34.     WPARAM wParam, LPARAM lParam) {
  36.     HWND hsti;
  38.     switch(msg) {
  40.         case WM_CREATE:
  42.             LoadMyImage();
  43.             hsti = CreateWindowW(L"Static", L"", 
  44.                 WS_CHILD | WS_VISIBLE | SS_BITMAP,
  45.                 5, 5, 300, 300, hwnd, (HMENU) 1, NULL, NULL);
  47.             SendMessage(hsti, STM_SETIMAGE,
  48.                 (WPARAM) IMAGE_BITMAP, (LPARAM) hBitmap); 
  49.             break;
  51.         case WM_DESTROY:
  53.             DeleteObject(hBitmap);
  54.             PostQuitMessage(0);
  55.             break;
  56.     }
  58.     return DefWindowProcW(hwnd, msg, wParam, lParam);
  59. }
  61. void LoadMyImage(void) {
  63.     hBitmap = LoadImageW(NULL, L"C:\\prog\\slovakia.bmp", IMAGE_BITMAP,
  64.         0, 0, LR_LOADFROMFILE);
  65. }

该示例在窗口上显示了 BMP 图像。

  1. hsti = CreateWindowW(L"Static", L"", 
  2.         WS_CHILD | WS_VISIBLE | SS_BITMAP,
  3.         5, 5, 300, 300, hwnd, (HMENU) 1, NULL, NULL);

SS_BITMAP常量使静态控件显示位图。

  1. SendMessage(hsti, STM_SETIMAGE,
  2.         (WPARAM) IMAGE_BITMAP, (LPARAM) hBitmap);

发送STM_SETIMAGE消息以将新图像与静态控件关联。

  1. void LoadMyImage(void) {
  3.     hBitmap = LoadImageW(NULL, L"C:\\prog\\slovakia.bmp", IMAGE_BITMAP,
  4.         0, 0, LR_LOADFROMFILE);
  5. }

LoadImageW()函数从文件系统加载位图。 如果函数成功，则返回值是新加载的图像的句柄。

Windows API 控件 I - 图2

Static image control

按钮

按钮是带有文本标签的简单控件。 用于触发动作。 当我们单击一个按钮时，它会向其父窗口发送WM_COMMAND消息。 wParam参数的低位字包含控件标识符。

button.c

  1. #include <windows.h>
  3. LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  5. #define ID_BEEP 1
  6. #define ID_QUIT 2
  8. int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
  9.                     PWSTR lpCmdLine, int nCmdShow) {
  11.     MSG  msg;
  12.     WNDCLASSW wc = {0};
  13.     wc.lpszClassName = L"Buttons";
  14.     wc.hInstance     = hInstance;
  15.     wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
  16.     wc.lpfnWndProc   = WndProc;
  17.     wc.hCursor       = LoadCursor(0, IDC_ARROW);
  19.     RegisterClassW(&wc);
  20.     CreateWindowW(wc.lpszClassName, L"Buttons",
  21.                   WS_OVERLAPPEDWINDOW | WS_VISIBLE,
  22.                   150, 150, 300, 200, 0, 0, hInstance, 0);
  24.     while (GetMessage(&msg, NULL, 0, 0)) {
  26.         TranslateMessage(&msg);
  27.         DispatchMessage(&msg);
  28.     }
  30.     return (int) msg.wParam;
  31. }
  33. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
  34.     WPARAM wParam, LPARAM lParam) {
  36.     switch(msg) {
  38.         case WM_CREATE:
  40.             CreateWindowW(L"Button", L"Beep",
  41.                 WS_VISIBLE | WS_CHILD ,
  42.                 20, 50, 80, 25, hwnd, (HMENU) ID_BEEP, NULL, NULL);
  44.             CreateWindowW(L"Button", L"Quit",
  45.                 WS_VISIBLE | WS_CHILD ,
  46.                 120, 50, 80, 25, hwnd, (HMENU) ID_QUIT, NULL, NULL);
  47.             break;
  49.         case WM_COMMAND:
  51.             if (LOWORD(wParam) == ID_BEEP) {
  53.                 MessageBeep(MB_OK);
  54.             }
  56.             if (LOWORD(wParam) == ID_QUIT) {
  58.                 PostQuitMessage(0);
  59.             }
  61.             break;
  63.         case WM_DESTROY:
  65.             PostQuitMessage(0);
  66.             break;
  67.     }
  69.     return DefWindowProcW(hwnd, msg, wParam, lParam);
  70. }

在我们的示例中，我们创建了两个按钮。 一键鸣音。 另一个将关闭窗口。

  1. CreateWindowW(L"Button", L"Beep",
  2.     WS_VISIBLE | WS_CHILD ,
  3.     20, 50, 80, 25, hwnd, (HMENU) ID_BEEP, NULL, NULL);

按钮控件是使用L"Button"类创建的。

  1. case WM_COMMAND:
  3.     if (LOWORD(wParam) == ID_BEEP) {
  5.         MessageBeep(MB_OK);
  6.     }
  8.     if (LOWORD(wParam) == ID_QUIT) {
  10.         PostQuitMessage(0);
  11.     }
  13.     break;

控件的 ID 在wParam的LOWORD中。 根据 ID，我们称为MessageBeep()函数或PostQuitMessage()函数。

Windows API 控件 I - 图3

Button controls

CheckBox

复选框控件是可以单击以打开或关闭选项的框。

checkbox.c

  1. #include <windows.h>
  2. #include <stdbool.h>
  4. LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  6. int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
  7.                     PWSTR lpCmdLine, int nCmdShow) {
  9.     MSG  msg;    
  10.     WNDCLASSW wc = {0};
  11.     wc.lpszClassName = L"Check Box";
  12.     wc.hInstance     = hInstance ;
  13.     wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
  14.     wc.lpfnWndProc   = WndProc;
  15.     wc.hCursor       = LoadCursor(0, IDC_ARROW);
  17.     RegisterClassW(&wc);
  18.     CreateWindowW(wc.lpszClassName, L"Check Box",
  19.                   WS_OVERLAPPEDWINDOW | WS_VISIBLE,
  20.                   150, 150, 230, 150, 0, 0, hInstance, 0);
  22.     while (GetMessage(&msg, NULL, 0, 0)) {
  24.         TranslateMessage(&msg);
  25.         DispatchMessage(&msg);
  26.     }
  28.     return (int) msg.wParam;
  29. }
  31. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
  32.     WPARAM wParam, LPARAM lParam) {
  34.     bool checked = true;
  36.     switch(msg) {
  38.         case WM_CREATE:
  40.             CreateWindowW(L"button", L"Show Title",
  41.                 WS_VISIBLE | WS_CHILD | BS_CHECKBOX,
  42.                 20, 20, 185, 35, hwnd, (HMENU) 1, 
  43.                 NULL, NULL);
  45.             CheckDlgButton(hwnd, 1, BST_CHECKED);
  46.             break;
  48.         case WM_COMMAND:
  50.             checked = IsDlgButtonChecked(hwnd, 1);
  52.             if (checked) {
  54.                 CheckDlgButton(hwnd, 1, BST_UNCHECKED);
  55.                 SetWindowTextW(hwnd, L"");
  57.             } else {
  59.                CheckDlgButton(hwnd, 1, BST_CHECKED);
  60.                SetWindowTextW(hwnd, L"Check Box");
  61.             }
  63.             break;
  65.        case WM_DESTROY:
  67.             PostQuitMessage(0);
  68.             break;
  69.     }
  71.     return DefWindowProcW(hwnd, msg, wParam, lParam);
  72. }

在我们的示例中，我们根据复选框的状态显示或隐藏窗口标题。

  1. CreateWindowW(L"button", L"Show Title",
  2.     WS_VISIBLE | WS_CHILD | BS_CHECKBOX,
  3.     20, 20, 185, 35, hwnd, (HMENU) 1, 
  4.     NULL, NULL);

复选框是一种特殊的按钮。 它是用BS_CHECKBOX标志创建的。

  1. checked = IsDlgButtonChecked(hwnd, 1);

我们使用IsDlgButtonChecked()函数确定复选框的状态。

  1. CheckDlgButton(hwnd, 1, BST_UNCHECKED);

我们使用CheckDlgButton()函数选中并取消选中该复选框。

  1. SetWindowTextW(hwnd, L"");

SetWindowTextW()函数设置窗口的标题。

Windows API 控件 I - 图4

Checkbox control

编辑控件

编辑控件是一个矩形子窗口，用于输入和编辑文本。 它可以是单行或多行。

edit.c

  1. #include <windows.h>
  3. #define ID_EDIT 1
  4. #define ID_BUTTON 2
  6. LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  8. int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
  9.                     PWSTR lpCmdLine, int nCmdShow) {
  11.     MSG  msg;    
  12.     WNDCLASSW wc = {0};
  13.     wc.lpszClassName = L"Edit control";
  14.     wc.hInstance     = hInstance;
  15.     wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
  16.     wc.lpfnWndProc   = WndProc;
  17.     wc.hCursor       = LoadCursor(0, IDC_ARROW);
  19.     RegisterClassW(&wc);
  20.     CreateWindowW(wc.lpszClassName, L"Edit control",
  21.                   WS_OVERLAPPEDWINDOW | WS_VISIBLE,
  22.                   220, 220, 280, 200, 0, 0, hInstance, 0);  
  24.     while (GetMessage(&msg, NULL, 0, 0)) {
  26.       TranslateMessage(&msg);
  27.       DispatchMessage(&msg);
  28.     }
  30.     return (int) msg.wParam;
  31. }
  33. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
  34.     WPARAM wParam, LPARAM lParam) {
  36.     static HWND hwndEdit;
  37.     HWND hwndButton;
  39.     switch(msg) {
  41.         case WM_CREATE:
  43.             hwndEdit = CreateWindowW(L"Edit", NULL, 
  44.                 WS_CHILD | WS_VISIBLE | WS_BORDER,
  45.                 50, 50, 150, 20, hwnd, (HMENU) ID_EDIT,
  46.                 NULL, NULL);
  48.             hwndButton = CreateWindowW(L"button", L"Set title",
  49.                 WS_VISIBLE | WS_CHILD, 50, 100, 80, 25,
  50.                 hwnd, (HMENU) ID_BUTTON, NULL, NULL);
  52.             break;
  54.         case WM_COMMAND:    
  56.             if (HIWORD(wParam) == BN_CLICKED) {
  58.                 int len = GetWindowTextLengthW(hwndEdit) + 1;
  59.                 wchar_t text[len];
  61.                 GetWindowTextW(hwndEdit, text, len);
  62.                 SetWindowTextW(hwnd, text);
  63.             }
  65.             break;
  67.         case WM_DESTROY:
  68.             PostQuitMessage(0);
  69.             break;
  70.     }
  72.     return DefWindowProcW(hwnd, msg, wParam, lParam);
  73. }

在我们的示例中，我们有一个编辑控件和一个按钮。 我们可以将一些文本放入编辑控件中。 如果单击按钮，则输入的文本将显示在主窗口的标题栏中。

  1. hwndEdit = CreateWindowW(L"Edit", NULL, 
  2.     WS_CHILD | WS_VISIBLE | WS_BORDER,
  3.     50, 50, 150, 20, hwnd, (HMENU) ID_EDIT,
  4.     NULL, NULL);

编辑控件是使用L"Edit"窗口类创建的。 WS_BORDER窗口样式在控件周围创建细线边框。

  1. if (HIWORD(wParam) == BN_CLICKED) {
  3.    int len = GetWindowTextLengthW(hwndEdit) + 1;
  4.    wchar_t text[len];
  6.    GetWindowTextW(hwndEdit, text, len);
  7.    SetWindowTextW(hwnd, text);
  8. }

GetWindowTextLengthW()返回输入文本的长度。 注意，我们在长度上加 1。 这将包括零终止符。 尝试忽略它，看看会发生什么。 GetWindowTextW()从编辑控件接收文本。 该函数的第一个参数是包含文本的窗口或控件的句柄。 SetWindowTextW()设置窗口的文本。 在这种情况下，它是主窗口的标题。

Windows API 控件 I - 图5

图：编辑控件

在 Windows API 教程的这一部分中，我们介绍了四个基本的 Windows 控件。