Question

在这一小节中，我们来介绍一下怎样使用 wxMenu,它用一种相对简单的办法来提供一组命令但是却不占用大量的空间。在下一小节，我们会描述一下怎样在菜单条上使用菜单。

wxMenu

菜单是指的一串命令，它可以从菜单条弹出，也可以从任何一个窗口上作为关联菜单，通过通常是右键单击来弹出。菜单项可以是一个普通的命令，也可以是一个复选框或者是一个单选框。菜单项可以被禁用，这是它将不能触发任何命令。某些菜单项可以通过一下特殊的三角符号来带出一个新的菜单，菜单中有可以有新的特殊菜单项，这种循环可以使用任意多次。另外一种特殊的菜单项是一个分割条，它只是简单的显示一行或者一段空白以便把两组菜单项进行分割。

下图显示了一个典型的拥有普通菜单项，复选框，单选框以及子菜单的菜单：

上面的例子还演示了两种快捷操作方法：加速键和快捷键。加速键是通过前导符"&"指定的，使用下划线表示，当菜单显示的时候可以通过这个键来执行相应的命令。而快捷键则是一个组合键，它可以在菜单没有显示的时候执行菜单命令，它通过一个 TAB 加一个组合键被定义。例如，上图中的 New 菜单是通过下面的代码实现的：

menu->Append(wxID_NEW, wxT("&New...\tCtrl+N"));

更多通过菜单或者 wxAcceleratorTable 创建快捷键的方法将会在第 6 章说明。

菜单中的复选框和单选框的状态是由菜单类自动维护的。它们会在单击的时候自动将自己的状态改变，并且在下一次菜单展示的时候以新的状态展示。对于单选框来说，在改变自己状态的同时，它还会将其它同一组中的单选框更改为未选中的状态。你也可以在自己的代码中设置它们的状态（参考第 9 章）。

你可以通过 wxWindow::PopupMenu 函数将某个菜单在一个窗口的特定位置显示，比如下面的代码：

void wxWindow::OnRightClick(wxMouseEvent& event)
{
    if (!m_menu)
    {
        m_menu = new wxMenu;
        m_menu->Append(wxID_OPEN, wxT("&Open"));
        m_menu->AppendSeparator();
        m_menu->Append(wxID_EXIT, wxT("E&xit"));
    }
    PopupMenu(m_menu, event.GetPosition());
}

菜单事件在发送给它的父窗口以及进行其它的事件表匹配之前会首先发送给菜单自己。PopupMenu 函数会导致程序短暂堵塞，直到用户关闭这个菜单。如果你愿意，你可以每次都释放旧的并且重新创建新的菜单，也可以每次都使用同一个菜单。

你应该尽可能的使用系统预定义的菜单标识符，比如 wxID_OPEN, wxID_ABOUT, wxID_PRINT 等等，在第三章中有一个完整的列表。需要特别指出的是，在 Mac OS X 上，标识符为 wxID_ABOUT, wxID_PREFERENCES 和 wxID_EXIT 的菜单项不是显示在你定义的菜单中，而是显示在系统菜单中，wxWidgets 自动为你的菜单作了这个调整。但是你需要注意在调整以后不要留下类似空的帮助菜单，或者是两个菜单分割条连在一起这样的不专业的情况出现。

在 wxWidgets 的发行版的例子中的 samples/menu 例子演示了所有菜单的功能，而在另外一个 samples/ownerdrw 例子中，则演示了怎样在菜单中使用定制的字体和图片。

wxMenu 的事件

wxMenu 相关的事件类型总共有四种: wxCommandEvent, wxUpdateUIEvent, wxMenuEvent, 和 wxContextMenuEvent。

下表列出了处理函数使用 wxCommandEvent 作为参数类型的事件映射宏。可用其来处理菜单命令，无论是弹出菜单命令还是主菜单（来自类似 Frame 窗口的菜单条上的菜单）命令。这种事件宏和工具条上的事件映射宏是一致的，这使得菜单和工具条上的按钮产生的事件可以通过同一个处理函数处理。

EVT_MENU(id, func)	用来处理 wxEVT_COMMAND_MENU_SELECTED 事件，某个菜单项被选中的时候产生。
EVT_MENU_RANGE(id1, id2, func)	用来处理 wxEVT_COMMAND_MENU_RANGE 事件，在某个范围内的菜单项被选中的时候产生。

下表列出了处理函数使用 wxUpdateUIEvent 作为参数类型的事件映射宏。这种宏对应的事件是在系统空闲的时候产生的，以便给应用程序一个更新用户界面的机会。例如，允许或者禁止一个菜单项等。尽管 wxUpdateUIEvent 可以被任何窗口产生，但是菜单产生的 wxUpdateUIEvent 还是有一些不同的地方，在于在这个事件中可以调用 Check 函数，SetText 函数和 Enable 函数等。Check 函数用来选中或者不选某个菜单项，而 SetText 函数用来设置菜单项的标签。如果菜单项的标签需要根据某种条件动态改变的话会比较有用。例如：

BEGIN_EVENT_TABLE(MyFrame, wxFrame)
    EVT_UPDATE_UI(ID_TOGGLE_TOOLBAR, MyFrame::OnUpdateToggleToolbar)
END_EVENT_TABLE()
void MyFrame::OnUpdateToggleToolbar(wxUpdateUIEvent& event)
{
    event.Enable(true);
    event.Check(m_showToolBar);
    event.SetText(m_showToolBar ?
                  wxT("Show &Toolbar (shown)") :
                  wxT("Show &Toolbar (hidden)"));
}

EVT_UPDATE_UI(id, func)	用来处理 wxEVT_UPDATE_UI 事件. 处理函数可以调用 Enable, Check, 和 SetText 以及其它函数。
EVT_UPDATE_UI_RANGE(id1, id2, func)	用来处理 wxEVT_UPDATE_UI 事件，以便同时处理一组标识符。

关于界面更新的更多详情请参考第 9 章。

下表列出另外一些事件映射宏，其中 EVT_CONTEXT_MENU 的参数类型为 wxContextMenuEvent，这是一个从 wxCommandEvent 继承的事件类型，因此这个事件可以在父子窗口继承关系中传播。使用这个宏来拦截类似鼠标右键单击以产生关联菜单的事件，然后调用事件的 GetPosition 函数来获得菜单应该显示的准确位置。剩下的事件映射宏的处理函数采用 wxMenuEvent 对象作为参数，这些事件只从菜单条发送给其 frame 窗口，来告诉应用程序一个菜单已经被打开或者关闭了，或者某个菜单项正被高亮显示，默认的 EVT_MENU_HIGHLIGHT 的处理函数是在主程序的状态栏显示这个菜单项的帮助信息，不过你可以提供你自己的处理函数来作一些不同的事情。

EVT_CONTEXT_MENU(func)	用来处理由于用户或者通过某个特殊按键（在 windows 平台上），或者通过单击鼠标右键产生的弹出一个上下文菜单的请求。处理函数的参数类型为 wxContextMenuEvent。
EVT_COMMAND_CONTEXT_MENU(id, func)	和 EVT_CONTEXT_MENU 相似，不过多了一个窗口标识符参数。
EVT_MENU_OPEN(func)	用来处理 wxEVT_MENU_OPEN 事件，在一个菜单即将被打开的时候产生。在 windows 平台上主菜单上每次遍历只会导致一次这个事件产生。
EVT_MENU_CLOSE(func)	用来处理 wxEVT_MENU_CLOSE 事件，它在某个菜单被关闭的时候产生。
EVT_MENU_HIGHLIGHT(id, func)	用来处理 wxEVT_MENU_HIGHLIGHT 事件，当某个菜单项被高亮显示的时候产生，通常用来在主程序的状态栏上产生关于这个菜单项的帮助信息。
EVT_MENU_HIGHLIGHT_ALL(func)	用来处理 wxEVT_MENU_HIGHLIGHT 事件，在任何一个菜单项被高亮显示的时候产生。

wxMenu 的成员函数

Append 增加一个菜单项: 参数为标识符，菜单项标签，帮助信息和菜单项类型(wxITEMNORMAL, wxITEM_SEPARATOR, wxITEM_CHECK 或 wxITEM RADIO). 你也可以使用 AppendCheckItem 和 AppendRadioItem 来避免手动指定 wxITEM_CHECK 或 wxITEM_RADIO 参数类型.例如:

// 增加一个普通菜单项
menu->Append(wxID_NEW, wxT("&New...\tCtrl+N"));
// 增加一个复选框菜单项
menu->AppendCheckItem(ID_SHOW_STATUS, wxT("&Show Status"));
// 增加一个单选框菜单项
menu->AppendRadioItem(ID_PAGE_MODE, wxT("&Page Mode"));
Another overload of Append enables you to append a submenu, for example:
// 增加一个子菜单
menu->Append(ID_SUBMENU, wxT("&More options..."), subMenu);

还有一种 Append 的重载函数允许你直接使用一个 wxMenuItem 来增加一个菜单项，这是在菜单中增加图片或者使用自定义字体唯一的方法：

// 初始化图片和字体
wxBitmap bmpEnabled, bmpDisabled;
wxFont fontLarge;
// 创建一个菜单项
wxMenuItem* pItem = new wxMenuItem(menu, wxID_OPEN, wxT("&Open..."));
// 设置图片和字体
pItem->SetBitmaps(bmpEnabled, bmpDisabled);
pItem->SetFont(fontLarge);
// 增加到菜单中
menu->Append(pItem);

使用 Insert 函数来在特定的位置插入一个菜单项。使用 Prepend, PrependCheckItem, PrependRadioItem 和 PrependSeparator 在菜单最开始的地方插入一个菜单项。

AppendSeparator 插入一个分割条, InsertSeparator 在特定位置插入一个分割条。

// 插入一个分割条
menu->AppendSeparator();

Break 函数在菜单里插入一个中断点，导致下一个插入的菜单项出现在另外一栏。

使用 Check 函数是标记复选框或者单选框的状态，参数为菜单项标识符和一个 bool 值。使用 IsChecked 函数来获取当前状态。

Delete 函数删除并且释放一个菜单项使用菜单项标识符或者 wxMenuItem 指针。如果这个菜单项是一个子菜单，则子菜单将不被删除。如果你想删除并且释放一个子菜单，使用 Destroy 函数。Remove 函数移除一个菜单项但是并不释放它，而是返回指向它的指针。

使用 Enable 函数来允许或者禁止一个菜单项。但是比直接调用这个方法更好的作法是处理用户界面更新事件（参考第 9 章）。IsEnabled 函数返回当前的可用状态。

使用 FindItem 函数根据标签或者标识符找到一个菜单项，使用 FindItemByPosition 函数通过位置找到一个菜单项。

GetHelpString 和 SetHelpString 函数用来访问菜单项的帮助信息.当菜单是菜单条的一部分时，高亮显示的菜单项的帮助信息将会显示在状态栏上。

GetLabel 和 SetLabel 用来获取或者设置菜单项的标签。

GetMenuCount 返回菜单项的个数。

GetMenuItems 返回一个 wxMenuItemList 类型的菜单项的列表。

GetTitle 和 SetTitle 用来获取或者设置菜单的可选标题，这个标题通常只在弹出菜单中有意义。

UpdateUI 发送用户界面更新事件到其参数只是的事件处理对象，如果参数为 NULL 则发往菜单的父窗口.这个函数在菜单即将显示之前会被调用，但是应用程序也可以在自己认为需要的时候调用它。