《Windows API每日一练》9.2.1 菜单

■和菜单有关的概念

窗口的菜单栏紧挨着标题栏下面显示。这个菜单栏有时叫作程序的“主菜单”或“顶级菜单“（top-level menu）。顶级菜单中的菜单项通常会激活下拉菜单（drop-downmenu），也 叫“弹出菜单”（popup menu）或“子菜单”（submenu）。你可以定义多级嵌套的弹出菜单： 一个弹出菜单项可以激活另一个出菜单。有时弹出菜单项可以激活对话框来提供更多信息。（对话框在第十章讨论。）许多父窗口在标题栏的最左边显示程序的小图标。这个图标会激活系统菜单，该菜单实际上是另一种弹出菜单。

●弹出菜单的菜单项可以被“选中”（checked），亦即Windows在菜单文本左边显示一个 小的选中标记。选中标记的使用让用户可以选择不同的程序选项。这些选项可以是互相排斥的，当然不是必须要这样做。顶级菜单项不能被选中。

●顶级菜中或弹出菜单的菜单项可以被“启用”（enabled)、“禁用”（disabled）或“变灰”（grayed）。单词“活动”（Active）和“非活动” （Inactive）有时可以和“启用”和“禁用”同义使用。标记为启用或禁用的菜单项对用户来讲看起来一样，但变灰菜单项显示为灰色文本。

从用户的角度看，启用、禁用或变灰的菜单项都能被“选择”（加亮）。也就是说，用户可以在禁用的菜单项上单击鼠标，或者将反色显示（reverse-video）的光标条移动到一个禁 用的菜单项，或者使用菜单项的快捷键字母来触发禁用的菜单项。然而，从程序的角度，启用、 禁用或变灰的菜单项功能不同。Windows只向被启用的菜单项发送WM_COMMAND消息。对当前无效的菜单选项你可使用禁用或变灰的办法。如果你想让用户知道选项是无效的，最好将它变灰。

差别	主菜单（顶级菜单）		子菜单（弹出菜单）
被选中(checked)	不能		可以
启用/禁用  （enabled/disabled） 活动/非活动（Active/Inactive）	可以		可以
变灰（grayed）	可以		可以
WM_COMMAND消息	启用时，可发送。禁用或变灰里不能
句柄	有独立句柄	有独立句柄

■菜单结构

在程序中创建或修改菜单时，将顶级菜单和每个弹出菜单想象成独立的菜单会有利于理解。顶级菜单有一个菜单句柄，在顶级菜单中的每个弹出菜单也都有自己的菜单句柄，系统菜单（也是一个弹出菜单）也有一个菜单句柄。

每个菜单项由三个特征定义。第一个特征是菜单显示什么。这可以是一个文本字符串或是一个位图。第二个特征是一个ID号或一个指向弹出菜单的句柄，Windows会在 WM_COMMAND消息中把ID号发送给你的程序，而弹出菜单则在用户选择该菜单项时由 Windows显示出来。第三个特征描述了菜单项的属性，包括该菜单项是否被禁用、变灰或选中。

■定义菜单

要使用VS给程序的资源脚本加入菜单，应从Insert菜单中选择Resource，然后选择Menu。然后你就可以交互式定义菜单。菜单中的每一项都有一个相关联的Menu Item Properties对话框，用来指示菜单项的文本字符串。 如果Pop-up框被选中，则该菜单项会激活一个弹出菜单，这时它没有相关联的ID。如果 Pop-up框没被选中，那么该菜单项会生成一个带有特定ID的WM_COMMAND消息。这两种类型的菜单项会分别以POPUP和MENUITEM语句的形式在资源脚本中出现。

图9-10 创建菜单项

在为菜单中的一项输入文本时，可以输入一个符号&来指示Windows在显示菜单时给 紧接着&的下一个字符显示下划线。用Alt键选择一个菜单项时，Windows就寻找这样一个 带下划线的字符。如果不在文本中包含字符&,下划线不会出现，Windows将会用菜单项文本的第一个字母来进行Alt键搜索。

如果在Menu Items Properties对话框中选择了 Grayed选项，则表示该菜单项是非活动

的，它的文本会变灰，并且不会产生WM_COMMAND消息。如果选择Inactive选项，则表示该菜单项是非活动的，不会产生WM_COMMAND消息，但是它的文本会被正常显示。 Checked选项会在菜单项的旁边加一个复选标记。Separator选项会在弹出菜单上绘制一条 水平的分隔线。

对弹出菜单中的菜单项，可以在字符串中使用分栏制表符\t。即使弹出菜单第一栏的字 符串很长，\t后面的文本也会被放置在右边足够远的新一栏中。当我们学习键盘加速键时，我们会看到它是如何工作的。字符串中的\a会将它后面的文本进行右对齐。

指定的ID值是Windows在菜单消息中发给窗口过程的数字。ID值在一个菜单中应该 是唯一的。按照惯例，我们 使用以IDM（ID for a Menu）开头的标识符。                       

图9-11 设置菜单属性

                                                              

●菜单的单个特征：

特征	说明
①显示内容	1、表示文本字符串或位图。 2、带&指示紧接的字符显示下划线，配合Alt键搜索 3、Spparator绘制水平分隔线 4、\t制表符后面的文本在新一栏中 5、\a后面的文本进行右对齐
②ID	该项为MENUITEM（菜单项）：则为菜单ID，会发送WM_COMMAND 为POPUP（弹出菜单）： 为菜单句柄
③属性	是否被禁用、变灰或选中等。非活动时，不会产生WM_COMMAND消息。

                                  

■在程序中引用菜单

大多数Windows应用程序在资源脚本中只有一个菜单。可以给该菜单指定一个与程序 名一样的文本名字。程序员经常使用程序名作为菜单名，这样同一字符串可以作为窗口类名、程序图标名和菜单名。然后程序可以在窗口类定义中引用这个菜单：

wndclass.IpszMenuName = szAppName;

虽然在窗口类中指定菜单是引用菜单资源的最通常的方法，但它不是唯一的方法。 Windows应用程序可以用LoadMenu函数把菜单资源加载到内存，这和前面描述的Loadlcon 和LoadCursor函数非常类似。LoadMenu返回一个菜单的句柄。如果在资源脚本中为菜单设定了一个名字，那么该语句看起来会像这样：

hMenu = LoadMenu (hlnstance, TEXT ("MyMenu"));

如果使用数字，那么LoadMenu调用格式如下：

hMenu = LoadMenu (hlnstance, MAKEINTRESOURCE (ID_MENU))

之后便可以把这个菜单句柄指定为CreateWindow的第9个参数：

hvmd = CreateWindow (TEXT ("MyClass"), TEXT ("Window Caption"),

WS_OVERLAPPEDWINDOW,

                            CW_USEDEFAULT, CW_USEDEFAULT,                    

                            CW_USEDEFAULT, CW_USEDEFAULT,                    

                            NULL, hMenu, hlnstance, NULL);

这种情况下，CreateWindow中指定的菜单会覆盖窗口类中指定的任何菜单。如果 CreateWindow的第9个参数是NULL，那么你可以认为窗口类中的菜单是基于该窗口类的 所有窗口的默认菜单。因此，你可以对基于同一窗口类的几个不同窗口使用不同的菜单。

还可以在窗口类中指定一个NULL菜单名，并在CreateWindow调用中使用一个NULL 菜单句柄，然后在窗口创建之后再给它指派一个菜单：

SetMenu (hwnd, hMenu);

这种形式可以让你动态地改变窗口的菜单。我们会在本章后面的NOPOPUPS程序中看到 这样的一个例子。

当窗口被销毁时，附加到该窗口的任何菜单也将被销毁。而在程序结束前，任何没有附加到窗口的菜单应该通过DestroyMenu调用被显式地销毁。

■其他菜单命令

除了之前已经介绍的菜单函数，还有更多和菜单相关的有用函数。

●当你改变一个顶级菜单项时，该改动直到Windows重绘菜单栏时才会被显示出来。你 可以调用下面的语句来强制重绘：

DrawMenuBar (hwnd);

【注意】DrawMenuBar的参数是一个指向窗口的句柄，而非菜单句柄。

●可以使用如下语句来获得弹出菜单的句柄：

hMenuPopup = GetSubMenu (hMenu, iPosition);

其中iPosition是弹出菜单在顶级菜单中的索引（从0开始），hMenu代表顶级菜单。然后便可以在其他函数(例如AppendMenu)中使用该弹出菜单句柄。

●使用如下语句，可以获得顶级菜单或弹出菜单中现有菜单项的数目：

iCount = GetMenuICemCount (hMenu);

●可以使用下面的语句来获得弹出菜单中某个菜单项的菜单ID：

 id = GetMenuItemID (hMenuPopup, iPosition);

其中iPosition是该菜单项在弹出菜单中的位置(从0开始)。

●在MENUDEMO中，展示了如何使用下面的语句在弹出菜单中“选中”和“取消选中” 某个菜单项：

CheckMenuItem (hMenu, id, iCheck);

在MENUDEMO中，hMenu是顶级菜单的句柄，id是菜单ID，iCheck的值是MF_CHECKED 或MF_UNCHECKED。如果hMenu是弹出菜单的句柄，那么id参数可以是位置索引而非菜单ID。如果使用索引更加方便，那么你可以在第三个参数中包含MF_BYPOSmON：

CheckMenuItem (hMenu, iPosition, MF_CHECKED | MF_BYP0SITI0N)；

EnableMenuItem和CheckMenuItem函数类似，不同之处在于第三个参数是 MF_ENABLED、MF_DISABLED、或MF_GRAYED。如果你在顶级菜单项上使用 EnableMenuItem，而该菜单项还有弹出菜单，那么你必须在第三个参数中使用 MF_BYPOSITION标识符，因为该菜单项没有菜单ID。我们会在本章后面的POPPAD2程序中看到EnableMenuItem函数的示例。HiliteMenuItem函数和CheckMenuItem以及 EnableMenuItem类似，但它使用标志MF_HILITE和MF_UNHILITE。这种加亮使用的是 反色显示（Reverse Video），在你在菜单项之间移动时Windows使用的就是这种加亮形式。 通常情况下不需要使用HiliteMenuItem。

●获取菜单中使用的是什么字符串？你可以调用下面的语句：

iCharCount = GetMenuScring (hMenu, id, pString, iMaxCount, iFlag);

iFlag可以是MF_BYCOMMAND（此时id是一个菜单ID）或者MF_BYPOSITION（此时id是 一个位置索引）。该函数复制至多iMaxCount个字符到pString,并返回复制的字符数。

●或者你想知道一个菜单项的当前标志，可以调用：

iFlags = GeCMenuSCaCe (hMenu, id, iFlag);

同样，iFlag是MF_BYCOMMAND或MF_BYPOSmON之一。iFlag参数是所有当前标志 的组合值。你可以针对 MF_DISABLED、MF_GRAYED、MF_CHECKED、 MF_MENUBREAK、MF_MENUBARBREAK 和 MF_SEPARATOR 标识符进行检测，以确定当前的标志。

●当应用程序不再需要菜单时，通过下面的语句可以销毀它：

DestroyMenu (hMenu) ;

这个函数使该菜单句柄无效。