如何定制对话框系统菜单
如何定制对话框系统菜单
作者：NorthTibet
背景
系统菜单是每个 Windows 程序的标准特性。通常系统菜单由 Windows
系统来管理，所以我们平时编成时很少去碰它。但是，有的时候，我们确实想定制自己的系统菜单项。这样就涉及到定制菜单的处理问题，因为 Windows
无法自动处理我们定制的系统菜单。而且，系统菜单的处理方式与常规的菜单处理是不同的。那么我们如何实现定制的系统菜单呢？相信看完本文的介绍，你会得到满意的答案。
本文例子是一个典型的C++/MFC对话框程序，设置了 EX_WM_TOOLWINDOW
扩展式样，因此在标题栏左上角看不到系统菜单图标，但通过 Ctrl+Space
或者在标题栏单击鼠标右键可以调出系统菜单。例子程序对系统菜单进行了定制，在原有菜单基础上添加了两个菜单命令：一个是显示“关于”对话框；另一个是“退出”。之所以要加一个“退出”菜单命令，是因为例子程序改写了对话框原来默认的“关闭”菜单命令行为（Alt-F4），用来隐藏对话框。因此必须加一个程序的“退出”出口。此外，例子程序利用一个第三方的系统托盘处理类，利用系统托盘图标可以显示/隐藏对话框。
下面我们就来看看用 C++/MFC 实现的细节。
添加菜单
首先在资源定义文件 resource.h
中定义菜单项标示，也可以在标准头文件中定义。菜单项标示必须具有唯一性。其次，Windows
对系统菜单的处理与常规菜单的处理方法是不同的，不管是缺省的菜单还是定制的菜单，它们都没有象常规菜单命令那样的消息处理例程。假设我们要添加两个定制的系统单：
#define IDM_ABOUT 16
#define IDM_EXIT 17
IDM_的意思是该定义为菜单项ID。添加菜单命令是在对话框的初始化例程以及窗口创建函数（OnInitDialog(), OnCreate()）中进行的。如：
BOOL CBabelOnDlg::OnInitDialog()
{
CDialog::OnInitDialog();
// 在系统菜单中添加 "关于..." 和 "退出" 菜单项
// 解决 Windows 95 中的 bug
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
// 命令 IDs 必须在预定义的系统菜单之后
ASSERT(IDM_ABOUTBOX AppendMenu(MF_STRING,IDM_EXIT,"退出(&x)");
pSysMenu-AppendMenu(MF_SEPARATOR);
pSysMenu-AppendMenu(MF_STRING, IDM_ABOUTBOX, "关于(&A)...");
......
}
......
//other initialization
}
这里在添加每个菜单前都有两个 ASSERT 语句，第一个 ASSERT 的目的是修复 Windows 95 中存在的 Bug，第二个 ASSERT
保证定制的命令 IDs 是在预定义的系统菜单之后，以免发生冲突。查一下 MSDN 库的 MFC 文档关于系统菜单的描述，你会发现下面的内容：
“......所有预定义的控制菜单项（也就是系统菜单）的ID号必须大于 0xF000。如果某个应用程序要添加系统菜单，
其系统菜单的 ID 号必须小于F000。”
接下来，用 GetSystemMenu 函数获取系统菜单指针。调用时使用参数 FALSE 获取指针。如果用 TRUE
作为参数，那么该函数会将菜单重置回缺省状态。
如果得到的指针有效，接着调用菜单添加命令在系统菜单后面添加菜单项，传递菜单IDs以及菜单显示时所用的字符串。
处理定制的菜单命令
为了让这些系统菜单命令工作起来，我们不能依赖常规的菜单消息处理机制----即便菜单项相同。通常系统菜单通过 WM_SYSCOMMAND 消息处理：
void CBabelOnDlg::OnSysCommand(UINT nID, LPARAM lParam)
{
//trap our own system menu messages
if ((nID & 0xFFF0) == IDM_ABOUTBOX)
{
CAboutDlg dlgAbout;
dlgAbout.DoModal();
} else if ((nID & 0xFFF0)==SC_CLOSE){
OnClose();
} else if ((nID & 0xFFF0)==IDM_EXIT) {
::PostQuitMessage(0);
}
else {
CDialog::OnSysCommand(nID, lParam);
}
}
通过比较传入的菜单ID进行相应的处理。注意代码中又有两个“nID & 0xFFF0”，这主要也是解决 Windows 95 的
bug。如果选择“退出”，那么会向应用程序发送退出消息：::PostQuitMessage(0)。
注意第二个条件检查：SC_CLOSE 是个预定义的菜单常量。一般它是由 Windows
处理的，因为在例子程序中我们对它进行了定制，所以必须要自己处理它。本来 SC_CLOSE
是退出程序，但例子程序我们把它的行为改写成隐藏对话框，也就是将应用变成一个托盘小图标，处理例程见 OnClose()
函数。如果传入的菜单ID不等于任何定制的菜单项，那么就让 Windows 对它进行默认处理：
CDialog::OnSysCommand(nID, lParam);
下面是几个最常用的系统菜单命令：
菜单
说明
SC_CLOSE
关闭 CWnd 对象
SC_MAXIMIZE 或者 SC_ZOOM
最大化 CWnd 对象
SC_MINIMIZE 或者 SC_ICON
最小化 CWnd 对象
SC_MOVE
移动 CWnd 对象
SC_RESTORE
恢复窗口的正常位置和大小
SC_SIZE
改变 CWnd 对象大小
其它的几个系统菜单命令一般都是在特殊情况下才使用，有关细节请参考有关 WM_SYSCOMMAND 的文档。
修改现有的菜单命令
我们已经看到，系统菜单本身默认的处理行为是可以改变的，除此之外，系统菜单项的描述文本也是可以改变的，甚至还可以删除它们。为了修改才单命令的描述文本，我们可以用 pSysMenu 指针调用 ModifyMenu()
函数。例如，如果想要把“关闭”菜单项改成“隐藏”，可以象下面这么做：
pSysMenu->ModifyMenu(SC_CLOSE, MF_BYCOMMAND,IDM_HIDE, "隐藏(&H)");
MF_BYCOMMAND 参数告诉该函数将 SC_CLOSE 解释为命令 ID。IDM_HIDE 是新的菜单
ID。最后一个参数是菜单项的说明文本。还有一种调用 ModifyMenu() 的方法是使用 菜单项索引作为参数：
pSysMenu->ModifyMenu(0,MF_BYPOSITION,IDM_HIDE,"隐藏(&H)");
第一个参数 0 表示菜单项的索引，指第一个菜单。
删除菜单命令
例子程序拟将去掉系统菜单中的窗口“关闭”命令，暂且不说这样做是否合适，但是我们能做到这一点：
pSysMenu->RemoveMenu(SC_CLOSE,MF_BYCOMMMAND);
pSysMenu->RemoveMenu(0,MF_BYPOSITION);
第一行代码删除了与 SC_CLOSE 关联的菜单命令。而第二行代码表示删除系统菜单命令中的第一项。
用这种方式修改系统菜单尽管限定了应用程序的某些行为，但对于小型应用和实用程序来说有时是很有用的，尤其是当你想要从任务栏存取菜单命令时----也就是程序在后台运行或者以最小化方式运行，右键单击任务栏图标将弹出系统菜单。
