minigui-docs/programming-guide-zh/MiniGUIProgGuidePart6Chapter02-zh.md

按钮

按钮是除静态框之外使用最为频繁的一种控件。按钮通常用来为用户提供开关选择。MiniGUI 的按钮可划分为普通按钮、复选框和单选钮等几种类型。用户可以通过键盘或者鼠标来选择或者切换按钮的状态。用户的输入将使按钮产生通知消息，应用程序也可以向按钮发送消息以改变按钮的状态。

以 CTRL_BUTTON 为控件类名调用 CreateWindow 函数，即可创建按钮控件。

1.1 按钮的类型和风格

1.1.1 普通按钮

普通按钮是一个矩形，其中显示了通过 CreateWindow 传递的窗口标题。该矩形占用了在 CreateWindow 调用中给出的全部高度和宽度，而文字位于矩形的中心。

按钮控件主要用来触发一个立即回应的动作，并且不会长久保持开关信息。这种形态的按钮控件有两种窗口风格，分别叫做 BS_PUSHBUTTON 和 BS_DEFPUSHBUTTON。BS_DEFPUSHBUTTON 中的 “DEF” 代表 “默认”。当用来设计对话框时，BS_PUSHBUTTON 风格和 BS_DEFPUSHBUTTON 风格的作用不同，具有 BS_DEFPUSHBUTTON 的按钮将是默认接收 ENTER 键输入的按钮，而不管当前的输入焦点处于哪个控件上。但是当用作普通主窗口的控件时，两种型态的按钮作用相同，只是具有 BS_DEFPUSHBUTTON 风格的按钮的边框要粗一些。

当鼠标光标处在按钮中时，按下鼠标左键将使按钮用三维阴影重画自己，就好像真的被按下一样。放开鼠标按键时，就恢复按钮的原貌，并产生 BN_CLICKED 通知，当按钮拥有输入焦点时，在文字的周围就有虚线，按下及释放空格键与按下及释放鼠标按键具有相同的效果。

【提示】本指南对控件行为和表象的描述以默认的经典风格为准。

通常情况下，按钮文本会以单行的形式在垂直和水平方向居中显示，不会自动换行。不过，应用程序也可以通过指定 BS_MULTLINE 风格来指定显示多行文本。下面的程序段创建了两个普通按钮：

CreateWindow (CTRL_BUTTON,
"Push Button",
WS_CHILD | BS_PUSHBUTTON | BS_CHECKED | WS_VISIBLE,
IDC_BUTTON,
10, 10, 80, 30, hWnd, 0);

CreateWindow (CTRL_BUTTON,
"Multiple Lines Push Button",
WS_CHILD | BS_PUSHBUTTON | BS_MULTLINE | WS_VISIBLE,
IDC_BUTTON + 1,
100, 10, 80, 40, hWnd, 0);

上述代码段建立的普通按钮的显示效果如__图 1.1__ 所示。注意在使用 BS_MULTILINE 风格之后，文本将垂直向上对齐。

图 1.1 普通按钮

另外，也可以在普通按钮上显示位图或图标，这时要使用 BS_BITMAP 或者 BS_ICON 风格，并通过 CreateWindow 函数的 dwAddData 参数传递位图对象的指针或图标句柄。默认情况下位图或图标会缩放显示以充满整个按钮窗口范围，使用 BS_REALSIZEIMAGE 风格将使位图或图标显示在控件中部，不作任何缩放。下面的代码段建立了一个带位图的按钮，其效果见__图 1.2__。

hwnd = CreateWindow (CTRL_BUTTON,
"Close",
WS_CHILD | BS_PUSHBUTTON | BS_BITMAP |BS_REALSIZEIMAGE | BS_NOTIFY | WS_VISIBLE,
IDC_BUTTON + 4,
10, 300, 60, 30, hWnd, (DWORD) GetSystemBitmap (IDI_APPLICATION));

图 1.2 位图按钮

1.1.2 复选框

复选框是一个文字方块，文字通常出现在复选框的右边（如果你在建立按钮时指定了 BS_LEFTTEXT 风格，那么文字会出现在左边）。复选框通常用于允许用户对选项进行选择的应用程序中。复选框的常用功能如同一个开关：单击一次将显示选中标记，再次单击则会清除选中标记。

复选框最常用的两种风格是 BS_CHECKBOX 和 BS_AUTOCHECKBOX。在使用 BS_CHECKBOX 时，应用程序需要自己向该控件发送消息来设定选中标记；而使用 BS_AUTOCHECKBOX 风格时，控件会自动在选中和非选中状态之间切换。

其余两种复选框风格是 BS_3STATE 和 BS_AUTO3STATE，正如它们名字所暗示的，这两种风格能显示第三种状态——复选框内是灰色的，这种状态表明该复选框不能被选择或者禁止使用。

BS_3STATE 和 BS_AUTO3STATE 风格之间的区别和上面一样：前者需要应用程序来操作其状态，而后者由控件负责状态的自动切换。

默认情况下，复选框沿矩形的左边框对齐，并位于控件窗口范围的顶边和底边之间（垂直居中），在该矩形内的任何地方按下鼠标都会产生通知消息。使用 BS_LEFTTEXT 风格将使复选框靠右对齐，并将文本置于复选框的左边。用于文本对齐的风格 BS_LEFT、BS_CENTER、BS_RIGHT、BS_TOP、BS_VCENTER、BS_BOTTOM 等可用于复选框。

另外，使用 BS_PUSHLIKE 风格将使复选框以普通按钮的形式显示：选中时显示为按下状态，未选中时显示为正常状态。

下面的程序段创建了两个复选框，其效果在__图 1.3__ 中。

CreateWindow (CTRL_BUTTON,
"Auto 3-state check box",
WS_CHILD | BS_AUTO3STATE | WS_VISIBLE,
IDC_CHECKBOX,
10, 60, 150, 30, hWnd, 0);

CreateWindow (CTRL_BUTTON,
"Auto check box on left",
WS_CHILD | BS_AUTOCHECKBOX | BS_LEFTTEXT | BS_RIGHT | WS_VISIBLE,
IDC_CHECKBOX + 1,
170, 60, 150, 30, hWnd, 0);

图 1.3 复选框按钮

1.1.3 单选钮

单选按钮就像收音机上选台按钮一样，每一个按钮都对应一个频道，而且一次只能有一个按钮被按下。在对话框中，单选按钮组常常用来表示相互排斥的选项。与复选框不同，单选按钮的工作方式不同于开关，也就是说，当第二次按单选按钮时，它的状态会保持不变。

单选按钮的形状是一个圆圈，而不是方框，除此之外，它的行为很像复选框。圆圈内的加重圆点表示该单选按钮已经被选中。单选按钮有风格 BS_RADIOBUTTON 或 BS_AUTORADIOBUTTON 两种，后者会自动显示用户的选择情况，而前者不会。

默认情况下，单选按钮沿控件窗口的左边框对齐，并位于控件窗口范围的顶边和底边之间（垂直居中），在该矩形内的任何地方按下鼠标都产生通知消息。使用 BS_LEFTTEXT 风格将使单选按钮靠右对齐，并将文本置于按钮的左边。用于文本对齐的风格 BS_LEFT、BS_CENTER、BS_RIGHT、BS_TOP、BS_VCENTER、BS_BOTTOM 等可用于单选按钮。

另外，使用 BS_PUSHLIKE 风格将使单选按钮以普通按钮的形式显示：选中时显示为按下状态，未选中时显示为正常状态。下面的程序段创建了两个单选按钮，其效果见__图 1.4__。

CreateWindow (CTRL_BUTTON,
"Auto Radio Button 2",
WS_CHILD | BS_AUTORADIOBUTTON | WS_VISIBLE,
IDC_RADIOBUTTON + 1,
20, 160, 130, 30, hWnd, 0);

CreateWindow (CTRL_BUTTON,
"Auto Radio Button 2",
WS_CHILD | BS_AUTORADIOBUTTON | BS_LEFTTEXT | BS_RIGHT | WS_VISIBLE,
IDC_RADIOBUTTON + 4,
180, 160, 140, 30, hWnd, 0);

图 1.4 单选按钮

单选按钮通常成组使用，同一组单选按钮每一刻只能有一个被选中。在创建一组单选按钮时，我们需要设定它们的状态是互斥的，因此，要在创建第一个单选按钮时使用 WS_GROUP 风格，以将其设置为该组单选按钮的“打头按钮”。

1.2 按钮消息

应用程序通过给按钮发送消息来实现如下目的：

• 查询/设置复选框或者单选钮的选中状态：BM_GETCHECK、BM_SETCHECK
• 查询/设置普通按钮或者复选框的按下或释放状态：BM_GETSTATE、BM_SETSTATE
• 获取/设置位图按钮上的位图或者图标：BM_GETIMAGE、BM_SETIMAGE
• 发送 BM_CLICK 模拟用户鼠标的单击操作

应用程序向复选框或者单选钮发送 wParam 等于 BST_CHECKED 的 BM_SETCHECK 消息来显示其处于选中状态：

SendMessage (hwndButton, BM_SETCHECK, BST_CHECKED, 0);

其实 wParam 可取的值一共有三个，见__表 1.1__。这些值也是通过 BM_GETCHECK 消息返回的选中状态值。

表 1.1 复选框和单选钮的选中状态

状态标识符	含义
BST_UNCHECKED(0)	未选中
BST_CHECKED(1)	已选中
BST_INDETERMINATE(2)	不可用状态

我们可以通过给窗口发送 BM_SETSTATE 消息来模拟按钮闪动。以下的操作将导致按钮被按下：

SendMessage (hwndButton, BM_SETSTATE, BST_PUSHED, 0) ;

下面的调用使按钮恢复正常：

SendMessage (hwndButton, BM_SETSTATE, 0, 0) ;

对位图按钮，可使用 BM_GETIMAGE 和 BM_SETIMAGE 消息获取或设置位图对象或图标句柄：

int image_type;
PBITMAP btn_bmp;
HICON btn_icon;

int ret_val = SendMessage (hwndButton, BM_GETIMAGE, (WPARAM)&image_type, 0) ;

if (image_type == BM_IMAGE_BITMAP) {
        /* 该按钮使用的是位图对象 */
        btn_bmp = (PBITMAP) ret_val;
}
else {
        /* 该按钮使用的是图标对象 */
        btn_icon = (HICON) ret_val;
}

/* 将按钮图象设置为位图对象 */
SendMessage (hwndButton, BM_SETIMAGE, BM_IMAGE_BITMAP, btn_bmp) ;

/* 将按钮图象设置为图标对象 */
SendMessage (hwndButton, BM_SETIMAGE, BM_IMAGE_ICON, btn_icon) ;

另外，我们在应用程序中也可以通过向按钮发送 BM_CLICK 消息来模拟用户在按钮上的单击操作。

1.3 按钮通知码

具有 BS_NOTIFY 风格的按钮可产生的通知码主要有：

• BN_CLICKED：表明用户单击此按钮。该通知码的值为 0，因此，如果要在按钮的父窗口中处理该按钮发送过来的 BN_CLICKED 通知消息，只需判断 MSG_COMMAND 消息的 wParam 参数是否等于按钮的标识符即可。该通知的产生是默认的，将忽略按钮控件的 BS_NOTIFY 风格。
• BN_PUSHED：表明用户将此按钮按下。
• BN_UNPUSHED：表明用户将此按钮释放。
• BN_DBLCLK：表明用户在此按钮上进行了鼠标左键的双击操作。
• BN_SETFOCUS：表明按钮获得了输入焦点。
• BN_KILLFOCUS：表明按钮失去了输入焦点。

1.4 编程实例

通常，应用程序只需处理 BN_CLICKED 通知码，对复选框和单选钮，一般设置为自动状态，并在需要时发送 BM_GETCHECK 消息来获得选中状态。在对话框中，应用程序还可以使用__表 1.2__ 中的函数来快速获得按钮控件的状态信息。

表 1.2 对话框为处理按钮控件而提供的便利函数

函数名	用途	备注
CheckDlgButton	通过按钮标识符来改变按钮的选中状态
CheckRadioButton	通过按钮标识符来改变一组单选钮的选中状态	确保互斥选中
IsDlgButtonChecked	通过标识符判断按钮是否选中

清单 1.1 所示的程序代码，给出了一个按钮控件的综合性使用范例。该程序使用一个对话框来询问用户的口味，通过分组单选框来选择喜欢的小吃类型，并通过复选框来选择用户的一些特殊口味。该程序的完整源代码请见本指南示例程序包 mg-samples 中的 button.c 文件，其运行效果见__图 1.5__。

清单 1.1 按钮控件的使用范例

#include <stdio.h>
#include <stdlib.h>

#include <minigui/common.h>
#include <minigui/minigui.h>
#include <minigui/gdi.h>
#include <minigui/window.h>
#include <minigui/control.h>

#define IDC_LAMIAN              101
#define IDC_CHOUDOUFU           102
#define IDC_JIANBING            103
#define IDC_MAHUA               104
#define IDC_SHUIJIAO            105

#define IDC_XIAN                110
#define IDC_LA                  111

#define IDC_PROMPT              200

static DLGTEMPLATE DlgYourTaste =
{
        WS_BORDER | WS_CAPTION,
        WS_EX_NONE,
        120, 100, 300, 280,
        "你喜欢吃哪种风味的小吃",
        0, 0,
        12, NULL,
        0
};

static CTRLDATA CtrlYourTaste[] =
{ 
        {
                "static",
                WS_VISIBLE | SS_GROUPBOX, 
                16, 10, 130, 160,
                IDC_STATIC,
                "可选小吃",
                0
        },
        {
                "button",
                /* 使用 BS_CHECKED，初始时使其选中 */
                WS_VISIBLE | BS_AUTORADIOBUTTON | BS_CHECKED | WS_TABSTOP | WS_GROUP,
                36, 38, 88, 20,
                IDC_LAMIAN,
                "西北拉面",
                0
        },
        {
                "button",
                WS_VISIBLE | BS_AUTORADIOBUTTON, 
                36, 64, 88, 20, 
                IDC_CHOUDOUFU, 
                "长沙臭豆腐",
                0
        },
        {
                "button",
                WS_VISIBLE | BS_AUTORADIOBUTTON,
                36, 90, 88, 20,
                IDC_JIANBING,
                "山东煎饼",
                0
        },
        {
                "button",
                WS_VISIBLE | BS_AUTORADIOBUTTON,
                36, 116, 88, 20,
                IDC_MAHUA,
                "天津麻花",
                0
        },
        {
                "button",
                WS_VISIBLE | BS_AUTORADIOBUTTON,
                36, 142, 100, 20,
                IDC_SHUIJIAO,
                "成都红油水饺",
                0
        },
        {
                "static",
                WS_VISIBLE | SS_GROUPBOX | WS_GROUP, 
                160, 10, 124, 160,
                IDC_STATIC,
                "口味",
                0
        },
        {
                "button",
                WS_VISIBLE | BS_AUTOCHECKBOX,
                170, 38, 88, 20,
                IDC_XIAN,
                "偏咸",
                0
        },
        {
                "button",
                /* 使用 BS_CHECKED，初始时使其选中 */
                WS_VISIBLE | BS_AUTOCHECKBOX | BS_CHECKED, 
                170, 64, 88, 20, 
                IDC_LA, 
                "偏辣",
                0
        },
        {
                "static",
                WS_VISIBLE | SS_LEFT | WS_GROUP,
                16, 180, 360, 20,
                IDC_PROMPT,
                "西北拉面是面食中的精品，但街上的兰州拉面除外！",
                0
        },
        {
                "button",
                WS_VISIBLE | BS_DEFPUSHBUTTON | WS_TABSTOP | WS_GROUP,
                80, 220, 95, 28,
                IDOK, 
                "确定",
                0
        },
        {
                "button",
                WS_VISIBLE | BS_PUSHBUTTON | WS_TABSTOP,
                185, 220, 95, 28,
                IDCANCEL,
                "取消",
                0
        },
};

static char* prompts [] = {
        "西北拉面是面食中的精品，但街上的兰州拉面除外！",
        "长沙臭豆腐口味很独特，一般人适应不了。",
        "山东煎饼很难嚼 :(",
        "天津麻花很脆，很香！",
        "成都的红油水饺可真好吃啊！想起来就流口水。",
};

static void my_notif_proc (HWND hwnd, int id, int nc, DWORD add_data)
{
        /* 用户选择不同的小吃时，在下面的静态框中显示针对这种小吃的提示信息 */
        if (nc == BN_CLICKED) {
                SetWindowText (GetDlgItem (GetParent (hwnd), IDC_PROMPT), prompts [id - IDC_LAMIAN]);
        }
}

static int DialogBoxProc2 (HWND hDlg, int message, WPARAM wParam, LPARAM lParam)
{
        switch (message) {
                case MSG_INITDIALOG:
                {
                        int i;
                        /* 为小吃单选钮设定通知回调函数 */
                        for (i = IDC_LAMIAN; i <= IDC_SHUIJIAO; i++)
                        SetNotificationCallback (GetDlgItem (hDlg, i), my_notif_proc);
                }
                return 1;
                
                case MSG_COMMAND:
                switch (wParam) {
                        case IDOK:
                        case IDCANCEL:
                        EndDialog (hDlg, wParam);
                        break;
                }
                break;
                
        }
        
        return DefaultDialogProc (hDlg, message, wParam, lParam);
}

int MiniGUIMain (int argc, const char* argv[])
{
        #ifdef _MGRM_PROCESSES
        JoinLayer(NAME_DEF_LAYER , "button" , 0 , 0);
        #endif
        
        DlgYourTaste.controls = CtrlYourTaste;
        
        DialogBoxIndirectParam (&DlgYourTaste, HWND_DESKTOP, DialogBoxProc2, 0L);
        
        return 0;
}

#ifndef _MGRM_PROCESSES
#include <minigui/dti.c>
#endif

图 1.5 按钮控件的使用范例