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

在本章中，我们将结束有关 Windows API 控件的讨论。 我们将提到单选按钮，单选框，组合框和进度条。

RadioButton和分组框

在这里，我们介绍两个控件。分组框是围绕一组控件的矩形。 这些通常是单选按钮。 分组框具有描述控件的标签。 此控件的目的是对某种程度上相关的控件进行分组。单选按钮是一种特殊的按钮，用户可以选择但不能清除。 它允许用户从一组选项中选择一个独占选项。

radio_buttons.c

  1. #include <windows.h>
  3. #define ID_BLUE 1
  4. #define ID_YELLOW 2
  5. #define ID_ORANGE 3
  7. LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  9. HINSTANCE g_hinst;
  10. COLORREF g_color;
  12. int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
  13.                     PWSTR lpCmdLine, int nCmdShow) {
  15.     HWND hwnd;
  16.     MSG  msg ;    
  17.     WNDCLASSW wc = {0};
  18.     wc.lpszClassName = L"GroupBox";
  19.     wc.hInstance     = hInstance;
  20.     wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
  21.     wc.lpfnWndProc   = WndProc;
  22.     wc.hCursor       = LoadCursor(0, IDC_ARROW);
  24.     g_hinst = hInstance;
  26.     RegisterClassW(&wc);
  27.     hwnd = CreateWindowW(wc.lpszClassName, L"GroupBox",
  28.                   WS_OVERLAPPEDWINDOW | WS_VISIBLE,
  29.                   100, 100, 300, 170, 0, 0, hInstance, 0);  
  31.     while (GetMessage(&msg, NULL, 0, 0)) {
  33.         DispatchMessage(&msg);
  34.     }
  36.     return (int) msg.wParam;
  37. }
  39. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
  40.     WPARAM wParam, LPARAM lParam) {
  42.     HDC hdc;
  43.     PAINTSTRUCT ps;
  44.     HBRUSH hBrush, holdBrush;
  45.     HPEN hPen, holdPen;
  47.     switch(msg) {
  49.         case WM_CREATE:
  51.             CreateWindowW(L"Button", L"Choose colour", 
  52.                   WS_CHILD | WS_VISIBLE | BS_GROUPBOX,
  53.                   10, 10, 120, 110, hwnd, (HMENU) 0, g_hinst, NULL);
  54.             CreateWindowW(L"Button", L"Blue",
  55.                   WS_CHILD | WS_VISIBLE | BS_AUTORADIOBUTTON,
  56.                   20, 30, 100, 30, hwnd, (HMENU) ID_BLUE , g_hinst, NULL);
  57.             CreateWindowW(L"Button", L"Yellow",
  58.                   WS_CHILD | WS_VISIBLE | BS_AUTORADIOBUTTON,
  59.                   20, 55, 100, 30, hwnd, (HMENU) ID_YELLOW , g_hinst, NULL);
  60.             CreateWindowW(L"Button", L"Orange",
  61.                   WS_CHILD | WS_VISIBLE | BS_AUTORADIOBUTTON,
  62.                   20, 80, 100, 30, hwnd, (HMENU) ID_ORANGE , g_hinst, NULL);      
  63.             break;
  65.         case WM_COMMAND:
  67.             if (HIWORD(wParam) == BN_CLICKED) {
  69.                 switch (LOWORD(wParam)) {
  71.                     case ID_BLUE:
  72.                         g_color = RGB(0, 76, 255);
  73.                         break;
  74.                     case ID_YELLOW:
  75.                         g_color = RGB(255, 255, 0);
  76.                         break;
  77.                     case ID_ORANGE:
  78.                         g_color = RGB(255, 123, 0);
  79.                         break;
  80.                 }                    
  81.                 InvalidateRect(hwnd, NULL, TRUE);
  82.             }
  83.             break;
  85.         case WM_PAINT:
  87.             hdc = BeginPaint(hwnd, &ps);
  88.             hBrush = CreateSolidBrush(g_color);
  89.             hPen = CreatePen(PS_NULL, 1, RGB(0, 0, 0));
  90.             holdPen = SelectObject(hdc, hPen);
  91.             holdBrush = (HBRUSH) SelectObject(hdc, hBrush);
  93.             Rectangle(hdc, 160, 20, 260, 120);
  95.             SelectObject(hdc, holdBrush);
  96.             SelectObject(hdc, holdPen);
  97.             DeleteObject(hPen);
  98.             DeleteObject(hBrush);
  99.             EndPaint(hwnd, &ps);
  100.             break;
  102.         case WM_DESTROY:
  103.             PostQuitMessage(0);
  104.             break; 
  105.     }
  107.     return DefWindowProcW(hwnd, msg, wParam, lParam);
  108. }

在我们的示例中，我们有一个带有三个单选按钮的分组框。 通过单击单选按钮，我们为右侧的矩形选择背景色。

  1. CreateWindowW(L"Button", L"Choose colour", 
  2.         WS_CHILD | WS_VISIBLE | BS_GROUPBOX,
  3.         10, 10, 120, 110, hwnd, (HMENU) 0, g_hinst, NULL);

分组框是一种特殊的按BS_GROUPBOX样式创建的按钮。

  1. CreateWindowW(L"Button", L"Blue",
  2.         WS_CHILD | WS_VISIBLE | BS_AUTORADIOBUTTON,
  3.         20, 30, 100, 30, hwnd, (HMENU) ID_BLUE , g_hinst, NULL);

单选按钮也是BS_AUTORADIOBUTTON样式的特殊按钮。

  1. case ID_BLUE:
  2.     g_color = RGB(0, 76, 255);
  3.     break;

如果单击单选按钮，则将使用选定的颜色填充全局变量。 此变量用于创建填充矩形的画笔。

  1. InvalidateRect(hwnd, NULL, TRUE);

我们使矩形（在本例中为整个窗口）无效，这将导致重绘客户区。 这将启动WM_PAINT消息。 在WM_PAINT消息期间，我们绘制矩形。 在 GDI 一章中更详细地说明了绘图。

Windows API 控件 III - 图1

图：GroupBox中的单选按钮

ComboBox

组合框是编辑框或静态文本与列表的组合。 当我们需要从可用选项列表中选择一个项目时，将使用一个组合框。

combobox.c

  1. #include <windows.h>
  3. LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  5. HINSTANCE g_hinst;
  7. int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
  8.                     PWSTR lpCmdLine, int nCmdShow) {
  10.     HWND hwnd;
  11.     MSG  msg ;    
  12.     WNDCLASSW wc = {0};
  13.     wc.lpszClassName = L"Application";
  14.     wc.hInstance     = hInstance ;
  15.     wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
  16.     wc.lpfnWndProc   = WndProc ;
  17.     wc.hCursor       = LoadCursor(0,IDC_ARROW);
  19.     g_hinst = hInstance;
  21.     RegisterClassW(&wc);
  22.     hwnd = CreateWindowW(wc.lpszClassName, L"Combo box",
  23.                   WS_OVERLAPPEDWINDOW | WS_VISIBLE,
  24.                   100, 100, 270, 170, 0, 0, hInstance, 0);  
  26.     while (GetMessage(&msg, NULL, 0, 0)) {
  28.         DispatchMessage(&msg);
  29.     }
  31.     return (int) msg.wParam;
  32. }
  34. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
  35.         WPARAM wParam, LPARAM lParam) {
  37.     static HWND hwndCombo, hwndStatic;
  38.     const wchar_t *items[] = { L"FreeBSD", L"OpenBSD", 
  39.         L"NetBSD", L"Solaris", L"Arch" };
  41.     switch(msg) {
  43.         case WM_CREATE:
  45.               hwndCombo = CreateWindowW(L"Combobox", NULL, 
  46.                     WS_CHILD | WS_VISIBLE | CBS_DROPDOWN,
  47.                     10, 10, 120, 110, hwnd, NULL, g_hinst, NULL);   
  49.               CreateWindowW(L"Button", L"Drop down", 
  50.                     WS_CHILD | WS_VISIBLE,
  51.                     150, 10, 90, 25, hwnd, (HMENU) 1, g_hinst, NULL); 
  53.               hwndStatic = CreateWindowW(L"Static", L"", 
  54.                     WS_CHILD | WS_VISIBLE,
  55.                     150, 80, 90, 25, hwnd, NULL, g_hinst, NULL); 
  57.               for (int i = 0; i < 4; i++ ) {
  59.                   SendMessageW(hwndCombo, CB_ADDSTRING, 0, (LPARAM) items[i]);
  60.               }
  62.               break;
  64.         case WM_COMMAND:
  66.              if (HIWORD(wParam) == BN_CLICKED) {
  68.                   SendMessage(hwndCombo, CB_SHOWDROPDOWN, (WPARAM) TRUE, 0);
  69.              }
  71.              if (HIWORD(wParam) == CBN_SELCHANGE) {      
  73.                   LRESULT sel = SendMessage(hwndCombo, CB_GETCURSEL, 0, 0);
  74.                   SetWindowTextW(hwndStatic, items[sel]);
  75.              }
  76.              break;
  78.         case WM_DESTROY:
  80.             PostQuitMessage(0);
  81.             break; 
  82.     }
  84.     return DefWindowProcW(hwnd, msg, wParam, lParam);
  85. }

在我们的示例中，我们在窗口上放置了三个控件：一个组合框，一个按钮和一个静态文本。 静态文本显示组合框中当前选择的项目。 用于演示CBN_SELCHANGE组合框消息。 该按钮以编程方式打开组合框。

  1. hwndCombo = CreateWindowW(L"Combobox", NULL, 
  2.     WS_CHILD | WS_VISIBLE | CBS_DROPDOWN,
  3.     10, 10, 120, 110, hwnd, NULL, g_hinst, NULL);

要创建一个组合框，我们使用L"Combobox"窗口类。 CBS_DROPDOWN标志创建一个下拉列表。

  1. for (int i = 0; i < 4; i++ ) {
  3.     SendMessageW(hwndCombo, CB_ADDSTRING, 0, (LPARAM) items[i]);
  4. }

我们用项目填充组合框。 要向组合框添加字符串，我们发送CB_ADDSTRING消息。

  1. if (HIWORD(wParam) == BN_CLICKED) {
  3.     SendMessage(hwndCombo, CB_SHOWDROPDOWN, (WPARAM) TRUE, 0);
  4. }

单击该按钮将导致发送CB_SHOWDROPDOWN消息，该消息将以编程方式调用下拉框。

如果从组合框中选择一个项目，则窗口过程将接收WM_COMMAND消息，并在wParam参数的高位字中带有通知消息CBN_SELCHANGE。

  1. if (HIWORD(wParam) == CBN_SELCHANGE) {      
  3.     LRESULT sel = SendMessage(hwndCombo, CB_GETCURSEL, 0, 0);
  4.     SetWindowTextW(hwndStatic, items[sel]);
  5. }

我们找出当前选择的项目。 我们向组合框发送CB_GETCURSEL消息。 该函数返回当前所选项目的索引。 我们将静态文本设置为当前选择的字符串。

Windows API 控件 III - 图2

图：组合框

进度条

进度条是当我们处理冗长的任务时使用的控件。 它具有动画效果，以便用户知道我们的任务正在进行中。

progressbar.c

  1. #include <windows.h>
  2. #include <commctrl.h>
  4. #define ID_BUTTON 1
  5. #define ID_TIMER 2
  7. LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  8. void CreateControls(HWND);
  10. HWND hwndPrgBar;
  11. HWND hbtn;
  13. int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
  14.                     PWSTR lpCmdLine, int nCmdShow) {
  16.     HWND hwnd;
  17.     MSG  msg ;    
  18.     WNDCLASSW wc = {0};
  19.     wc.lpszClassName = L"Application";
  20.     wc.hInstance     = hInstance;
  21.     wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
  22.     wc.lpfnWndProc   = WndProc;
  23.     wc.hCursor       = LoadCursor(0, IDC_ARROW);
  25.     RegisterClassW(&wc);
  26.     hwnd = CreateWindowW(wc.lpszClassName, L"Progress bar",
  27.                 WS_OVERLAPPEDWINDOW | WS_VISIBLE,
  28.                 100, 100, 260, 170, 0, 0, hInstance, 0);  
  30.     while (GetMessage(&msg, NULL, 0, 0)) {
  32.         DispatchMessage(&msg);
  33.     }
  35.     return (int) msg.wParam;
  36. }
  38. LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
  39.         WPARAM wParam, LPARAM lParam) {
  41.     static int i = 0;
  43.     switch(msg) {
  45.         case WM_CREATE:
  47.             CreateControls(hwnd);
  48.             break;
  50.         case WM_TIMER:
  52.             SendMessage(hwndPrgBar, PBM_STEPIT, 0, 0);
  53.             i++;
  55.             if (i == 150) {
  57.                 KillTimer(hwnd, ID_TIMER);
  58.                 SendMessageW(hbtn, WM_SETTEXT, (WPARAM) NULL, (LPARAM) L"Start");
  59.                 i = 0;
  60.             }
  62.             break;
  64.         case WM_COMMAND:
  66.             if (i == 0) {  
  68.                 i = 1;
  69.                 SendMessage(hwndPrgBar, PBM_SETPOS, 0, 0);
  70.                 SetTimer(hwnd, ID_TIMER, 5, NULL);
  71.                 SendMessageW(hbtn, WM_SETTEXT, (WPARAM) NULL, (LPARAM) L"In progress");
  72.             }
  74.           break;
  76.         case WM_DESTROY:
  78.             KillTimer(hwnd, ID_TIMER);
  79.             PostQuitMessage(0);
  80.             break; 
  81.     }
  83.     return DefWindowProcW(hwnd, msg, wParam, lParam);
  84. }
  86. void CreateControls(HWND hwnd) {
  88.     INITCOMMONCONTROLSEX icex;
  90.     icex.dwSize = sizeof(INITCOMMONCONTROLSEX);
  91.     icex.dwICC  = ICC_PROGRESS_CLASS;
  92.     InitCommonControlsEx(&icex);
  94.     hwndPrgBar = CreateWindowEx(0, PROGRESS_CLASS, NULL, 
  95.           WS_CHILD | WS_VISIBLE | PBS_SMOOTH,
  96.           30, 20, 190, 25, hwnd, NULL, NULL, NULL);   
  98.     hbtn = CreateWindowW(L"Button", L"Start", 
  99.           WS_CHILD | WS_VISIBLE,
  100.           85, 90, 85, 25, hwnd, (HMENU) 1, NULL, NULL);  
  102.     SendMessage(hwndPrgBar, PBM_SETRANGE, 0, MAKELPARAM(0, 150));
  103.     SendMessage(hwndPrgBar, PBM_SETSTEP, 1, 0);
  104. }

在我们的示例中，我们有一个进度条和一个按钮。 该按钮启动一个计时器，该计时器更新进度条。

  1. hwndPrgBar = CreateWindowEx(0, PROGRESS_CLASS, NULL, 
  2.       WS_CHILD | WS_VISIBLE | PBS_SMOOTH,
  3.       30, 20, 190, 25, hwnd, NULL, NULL, NULL);

我们使用PROGRESS_CLASS类名称和PBS_SMOOTH样式创建进度条控件。

  1. SendMessage(hwndPrgBar, PBM_SETRANGE, 0, MAKELPARAM(0, 150));
  2. SendMessage(hwndPrgBar, PBM_SETSTEP, 1, 0);

我们设置进度条的范围及其步骤。

  1. i = 1;
  2. SendMessage(hwndPrgBar, PBM_SETPOS, 0, 0);
  3. SetTimer(hwnd, ID_TIMER, 5, NULL);

当按下开始按钮时，我们将i值设置为 1，设置进度条的初始位置，然后启动计时器。 计时器将定期向窗口过程发送WM_TIMER消息，直到被杀死。

  1. SendMessageW(hbtn, WM_SETTEXT, (WPARAM) NULL, (LPARAM) L"In progress");

当计时器进行时，我们更改按钮的标签。

  1. case WM_TIMER:
  3.     SendMessage(hwndPrgBar, PBM_STEPIT, 0, 0);
  4.     i++;
  6.     if (i == 150) {
  8.         KillTimer(hwnd, ID_TIMER);
  9.         SendMessageW(hbtn, WM_SETTEXT, (WPARAM) NULL, (LPARAM) L"Start");
  10.         i = 0;
  11.     }
  13.     break;

当我们收到WM_TIMER消息时，我们通过发送PBM_STEPIT消息的一步来更新进度条。 当i变量达到进度条的上限时，计时器将被终止。

Windows API 控件 III - 图3

图：进度条

在 Windows API 教程的这一部分中，我们已经完成了 Windows 控件的介绍。