# 24 菜单按钮

菜单按钮的功能和普通下拉式组合框的功能基本一样，实质上，在 MiniGUI 早期版本中，菜单按钮就是以组合框的替代品出现的。当然，菜单按钮有很大的限制，比如不能够编辑、不提供列表条目的滚动等等。

在外观上，菜单按钮类似一个普通按钮，不同的是在按钮矩形区域的右侧有一个向下的箭头。当用户点击该控件时，就会弹出一个菜单，而用户使用鼠标点击菜单中某一条目时，按钮的内容就变为该条目的内容。如__图 1.1__ 所示。

![菜单按钮（左边为平常状态，右边为弹出菜单后的效果）](figures/Part4Chapter06-1.1.jpeg
__图 1.1__ 菜单按钮（左边为平常状态，右边为弹出菜单后的效果）

以 `CTRL_MENUBUTTON` 为控件类名调用 `CreateWindow` 函数，即可创建菜单按钮。

## 1.1 菜单按钮风格

菜单按钮有一组自己特有的风格，一般使用如下的方式对风格进行组合。

```c
WS_CHILD | WS_VISIBLE | MBS_SORT
```

- `MBS_SORT`：对菜单按钮中的条目进行排序显示。
- `MBS_LEFTARROW`：箭头显示在菜单按钮的左侧。
- `MBS_NOBUTTON`：不显示按钮。
- `MBS_ALIGNLEFT`：菜单按钮上的文字向左对齐。
- `MBS_ALIGNRIGHT`：菜单按钮上的文字向右对齐。
- `MBS_ALIGNCENTER`：菜单按钮上的文字居中对齐。

当菜单条目使用位图的时候，位图的位置不受对齐方式的影响。

## 1.2 菜单按钮消息

### 1.2.1 向菜单按钮控件添加条目

向菜单按钮添加条目时使用 `MBM_ADDITEM` 消息，并传递一个经过初始化的 `MENUBUTTONITEM` 结构，如下所示：

```c
MENUBUTTONITEM mbi;       // 声明一个菜单条目结构体变量
mbi.text = "item one";    // 设置条目文字
mbi.bmp = NULL;           // 在这里可以指定位图对象
mbi.data = 0;
pos = SendMessage (hMbtnWnd, MBM_ADDITEM, -1, (LPARAM) &mbi);
```

其中，`hMbtnWnd` 是菜单按钮控件的句柄。`Pos` 得到新添加的菜单条目的索引值，当内存空间不足时，则返回 `MB_ERR_SPACE`。

### 1.2.2 从菜单按钮控件删除条目

从菜单按钮中删除条目，可使用 `MBM_DELITEM` 消息，并指定要删除的菜单项索引号。如下所示：

```c
SendMessage (hMbtnWnd, MBM_DELITEM, index, 0);
```

其中，`index` 为条目的索引值。

### 1.2.3 删除菜单中的所有条目

和列表框一样，菜单按钮也提供了删除所有条目的消息，即 `MBM_RESETCTRL` 消息。如下所示：

```c
SendMessage (hMbtnWnd, MBM_RESETCTRL, 0, 0);
```

### 1.2.4 设置当前选定条目

类似地，用 `MBM_SETCURITEM` 消息设置选中条目，被选中的条目文本将显示在菜单按钮上。如下所示：

```c
SendMessage (hMbtnWnd, MBM_SETCURITEM, index, 0);
```

其中，`index` 为要设定的条目索引值。

### 1.2.5 得到当前选定条目

用 `MBM_GETCURITEM` 消息可获得当前选中条目的索引号。如下所示：

```c
index = SendMessage (hMbtnWnd, MBM_GETCURITEM, 0, 0);
```

该消息返回当前选定条目的索引值。

### 1.2.6 获取或设置菜单项条目数据

使用 `MBM_GETITEMDATA` 和 `MBM_SETITEMDATA` 消息可获取或设置菜单项条目的数据。使用这个两个消息时，`wParam` 参数传递要获取或设置的菜单项索引值，`lParam` 参数传递一个指向 `MENUBUTTONITEM` 的结构指针，其中包括菜单项的文本、位图对象以及附加数据。

需要注意的是，`MENUBUTTONITEM` 结构中含有一个 `which` 成员，该成员指定了要获取或设置菜单项的哪个数据（文本、位图对象或者附加数据中的一个或多个），通常是下列值的组合：

- `MB_WHICH_TEXT`：表明要获取或设置菜单项的文本，这时，该结构的 `text` 成员必须指向有效缓冲区。
- `MB_WHICH_BMP`：表明要获取或设置菜单项的位图对象。
- `MB_WHICH_ATTDATA`：表明要获取或设置菜单项的附加数据。

示例如下：

```c
MENUBUTTONITEM mbi;

mbi.which = MB_WHICH_TEXT | MB_WHICH_ATTDATA;
mbi.text = “newtext”;
mbi.data = 1;
SendMessage (menubtn, MBM_SETITEMDATA, 0, (LPARAM) &mbi);
```

其中，`menubtn` 是某个菜单按钮的句柄。

### 1.2.7 其他消息

在使用 `MBS_SORT` 风格时，因为涉及到条目的排序，所以 MiniGUI 也为应用程序提供了 `MBM_SETSTRCMPFUNC` 消息，用来设定一个定制的排序函数。一般而言，应用程序要在添加条目之前使用该消息设定新的字符串比较函数。

该消息的用法可参照列表框消息 `LB_SETSTRCMPFUNC` 消息。

## 1.3 菜单按钮的通知消息

菜单按钮没有 `MBS_NOTIFY` 风格，因此，任意一个菜单按钮控件均可能产生如下的通知消息：

- `MBN_ERRSPACE`：内存分配失败，存储空间不足。
- `MBN_SELECTED`：对菜单按钮控件进行了选择。不管前后选择的菜单项是否改变，均会产生该通知消息。
- `MBN_CHANGED`：菜单按钮控件的选择项发生了变化。
- `MBN_STARTMENU`：用户激活了菜单按钮的弹出式菜单。
- `MBN_ENDMENU`：弹出式菜单关闭。

## 1.4 编程实例

__清单 1.1__ 给出了菜单按钮的使用实例。该程序段是对__清单 1.1__ 程序的一个小改动，即将__清单 1.1__ 程序中的下拉式组合框改成了菜单按钮来实现。该程序的完整源代码可见本指南示例程序包 `mg-samples` 中的 `menubutton.c` 文件，其运行效果见__图 1.2__。

__清单 1.1__ 菜单按钮的使用实例

```c
/* 定义对话框模板 */
static DLGTEMPLATE DlgMyDate =
{
        WS_BORDER | WS_CAPTION,
        WS_EX_NONE,
        100, 100, 304, 135,
        "约会大侠",
        0, 0,
        9, NULL,
        0
};

static CTRLDATA CtrlMyDate[] =
{ 
        
        ...
        
        /* 将用于显示大侠名单的组合框换成按钮菜单来实现 */
        {
                CTRL_MENUBUTTON,
                WS_CHILD | WS_VISIBLE,
                190, 20, 100, 20,
                IDL_DAXIA,
                "",
                0
        },
        
        ...
        
};

...

static void daxia_notif_proc (HWND hwnd, int id, int nc, DWORD add_data)
{
        if (nc == CBN_SELCHANGE) {
                /* 获得选定的大侠，并显示其性格特点 */
                int cur_sel = SendMessage (hwnd, MBM_GETCURITEM, 0, 0);
                if (cur_sel >= 0) {
                        SetWindowText (GetDlgItem (GetParent(hwnd), IDC_PROMPT), daxia_char [cur_sel]);
                }
        }
}

static void prompt (HWND hDlg)
{
        char date [1024];
        
        int hour = SendDlgItemMessage(hDlg, IDC_HOUR, CB_GETSPINVALUE, 0, 0);
        int min = SendDlgItemMessage(hDlg, IDC_MINUTE, CB_GETSPINVALUE, 0, 0);
        int sel = SendDlgItemMessage(hDlg, IDL_DAXIA, MBM_GETCURITEM, 0, 0);
        
        sprintf (date, "你打算于今日 %02d:%02d 去见那个%s的%s", hour, min, 
        daxia_char [sel], daxia [sel]);
        
        MessageBox (hDlg, date, "约会内容", MB_OK | MB_ICONINFORMATION);
}

static int MyDateBoxProc (HWND hDlg, int message, WPARAM wParam, LPARAM lParam)
{
        int i;
        switch (message) {
                case MSG_INITDIALOG:
                SendDlgItemMessage(hDlg, IDC_HOUR, CB_SETSPINFORMAT, 0, (LPARAM)"%02d");
                SendDlgItemMessage(hDlg, IDC_HOUR, CB_SETSPINRANGE, 0, 23);
                SendDlgItemMessage(hDlg, IDC_HOUR, CB_SETSPINVALUE, 20, 0);
                SendDlgItemMessage(hDlg, IDC_HOUR, CB_SETSPINPACE, 1, 1);
                
                SendDlgItemMessage(hDlg, IDC_MINUTE, CB_SETSPINFORMAT, 0, (LPARAM)"%02d");
                SendDlgItemMessage(hDlg, IDC_MINUTE, CB_SETSPINRANGE, 0, 59);
                SendDlgItemMessage(hDlg, IDC_MINUTE, CB_SETSPINVALUE, 0, 0);
                SendDlgItemMessage(hDlg, IDC_MINUTE, CB_SETSPINPACE, 1, 2);
                
                /* 向菜单按钮中加入各位大侠的名字 */
                for (i = 0; i < 7; i++) {
                        MENUBUTTONITEM mbi;
                        mbi.text = daxia[i];
                        mbi.bmp = NULL;
                        mbi.data = 0;
                        SendDlgItemMessage(hDlg, IDL_DAXIA, MBM_ADDITEM, -1, (LPARAM)&mbi);
                }
                
                /* 设定菜单按钮的通知回调函数 */
                SetNotificationCallback (GetDlgItem (hDlg, IDL_DAXIA), daxia_notif_proc);
                SendDlgItemMessage(hDlg, IDL_DAXIA, MBM_SETCURITEM, 0, 0);
                SetWindowText (GetDlgItem (hDlg, IDC_PROMPT), daxia_char [0]);
                return 1;
                
                case MSG_COMMAND:
                switch (wParam) {
                        case IDOK:
                        prompt (hDlg);
                        case IDCANCEL:
                        EndDialog (hDlg, wParam);
                        break;
                }
                break;
                
        }
        
        return DefaultDialogProc (hDlg, message, wParam, lParam);
}/* 定义对话框模板 */
static DLGTEMPLATE DlgMyDate =
{
        WS_BORDER | WS_CAPTION,
        WS_EX_NONE,
        100, 100, 304, 135,
        "约会大侠",
        0, 0,
        9, NULL,
        0
};

static CTRLDATA CtrlMyDate[] =
{ 
        
        ...
        
        /* 将用于显示大侠名单的组合框换成按钮菜单来实现 */
        {
                CTRL_MENUBUTTON,
                WS_CHILD | WS_VISIBLE,
                190, 20, 100, 20,
                IDL_DAXIA,
                "",
                0
        },
        
        ...
        
};

...

static void daxia_notif_proc (HWND hwnd, int id, int nc, DWORD add_data)
{
        if (nc == CBN_SELCHANGE) {
                /* 获得选定的大侠，并显示其性格特点 */
                int cur_sel = SendMessage (hwnd, MBM_GETCURITEM, 0, 0);
                if (cur_sel >= 0) {
                        SetWindowText (GetDlgItem (GetParent(hwnd), IDC_PROMPT), daxia_char [cur_sel]);
                }
        }
}

static void prompt (HWND hDlg)
{
        char date [1024];
        
        int hour = SendDlgItemMessage(hDlg, IDC_HOUR, CB_GETSPINVALUE, 0, 0);
        int min = SendDlgItemMessage(hDlg, IDC_MINUTE, CB_GETSPINVALUE, 0, 0);
        int sel = SendDlgItemMessage(hDlg, IDL_DAXIA, MBM_GETCURITEM, 0, 0);
        
        sprintf (date, "你打算于今日 %02d:%02d 去见那个%s的%s", hour, min, 
        daxia_char [sel], daxia [sel]);
        
        MessageBox (hDlg, date, "约会内容", MB_OK | MB_ICONINFORMATION);
}

static int MyDateBoxProc (HWND hDlg, int message, WPARAM wParam, LPARAM lParam)
{
        int i;
        switch (message) {
                case MSG_INITDIALOG:
                SendDlgItemMessage(hDlg, IDC_HOUR, CB_SETSPINFORMAT, 0, (LPARAM)"%02d");
                SendDlgItemMessage(hDlg, IDC_HOUR, CB_SETSPINRANGE, 0, 23);
                SendDlgItemMessage(hDlg, IDC_HOUR, CB_SETSPINVALUE, 20, 0);
                SendDlgItemMessage(hDlg, IDC_HOUR, CB_SETSPINPACE, 1, 1);
                
                SendDlgItemMessage(hDlg, IDC_MINUTE, CB_SETSPINFORMAT, 0, (LPARAM)"%02d");
                SendDlgItemMessage(hDlg, IDC_MINUTE, CB_SETSPINRANGE, 0, 59);
                SendDlgItemMessage(hDlg, IDC_MINUTE, CB_SETSPINVALUE, 0, 0);
                SendDlgItemMessage(hDlg, IDC_MINUTE, CB_SETSPINPACE, 1, 2);
                
                /* 向菜单按钮中加入各位大侠的名字 */
                for (i = 0; i < 7; i++) {
                        MENUBUTTONITEM mbi;
                        mbi.text = daxia[i];
                        mbi.bmp = NULL;
                        mbi.data = 0;
                        SendDlgItemMessage(hDlg, IDL_DAXIA, MBM_ADDITEM, -1, (LPARAM)&mbi);
                }
                
                /* 设定菜单按钮的通知回调函数 */
                SetNotificationCallback (GetDlgItem (hDlg, IDL_DAXIA), daxia_notif_proc);
                SendDlgItemMessage(hDlg, IDL_DAXIA, MBM_SETCURITEM, 0, 0);
                SetWindowText (GetDlgItem (hDlg, IDC_PROMPT), daxia_char [0]);
                return 1;
                
                case MSG_COMMAND:
                
                int MiniGUIMain (int argc, const char* argv[])
                {
                        #ifdef _MGRM_PROCESSES
                        JoinLayer(NAME_DEF_LAYER , "menubutton" , 0 , 0);
                        #endif
                        
                        DlgMyDate.controls = CtrlMyDate;
                        
                        DialogBoxIndirectParam (&DlgMyDate, HWND_DESKTOP, MyDateBoxProc, 0L);
                        
                        return 0;
                }
                
                ...
```

![使用菜单按钮](figures/Part4Chapter06-1.2.jpeg)
__图 1.2__ 使用菜单按钮