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