第6章 菜单和其他资源
资源是添加到程序可执行文件中的二进制数据,包括标准资源和自定义资源。标准资源包括菜单、图标、光标、位图、加速键(快捷键)、字符串表、程序版本信息、HTML和对话框等,自定义资源可以是程序所需的任何格式的数据。
6.1 菜单和加速键
菜单通常是一个程序必不可少的组成部分,这里以记事本程序为例说明一下与菜单有关的术语。记事本程序的菜单栏位于标题栏下方,这样的菜单栏称为程序的主菜单或顶级菜单;主菜单中有文件、编辑、格式、查看、帮助等菜单项,这些菜单项称为主菜单项;单击每一个主菜单项还可以弹出下一级菜单,这称为弹出菜单,例如单击主菜单项“文件”可以弹出子菜单项——新建、打开、保存、另存为等;单击主菜单项通常用于弹出子菜单项列表,单击子菜单项时系统才会发送命令消息,这些子菜单项也称为命令项;有的子菜单项中还包含下一级子菜单项列表,这样的子菜单项右边通常附带一个三角箭头。另外,单击标题栏左侧的小图标可以弹出一个系统菜单项列表,在某些程序窗口的客户区中单击鼠标右键也可以弹出一个子菜单项列表,这些都属于弹出菜单。只有重叠窗口或弹出窗口才能添加菜单栏,子窗口不可以。
注意:在本书中,主菜单项有时候也被我称之为弹出菜单,我在有的地方也可能不再刻意区分主菜单项与子菜单项,而是统称菜单项,菜单项指的是主菜单项还是子菜单项或是两者,读者在具体的上下文环境中可以区分开来。
6.1.1 为程序添加菜单栏
要为程序添加菜单,需要先添加菜单资源。最简单的方法是通过VS的资源视图添加,现在我们为Chapter6\HelloWindows程序添加菜单。单击VS软件左侧解决方案资源管理器的资源视图,右击HelloWindows项目→添加→资源,打开添加资源对话框,选择Menu并单击新建,如原书的图6.1所示。
可以看到VS自动为我们添加了HelloWindows.rc资源脚本文件,在该资源脚本文件中添加了Menu类型的ID为IDR_MENU1的菜单资源(也叫菜单模板)。选中左侧资源视图中的IDR_MENU1,打开VS软件右侧的属性对话框。属性对话框中显示了菜单资源IDR_MENU1的相关属性,如原书的图6.2所示。
修改菜单资源ID为IDR_MENU。
现在可以给菜单资源添加菜单项列表了,我们在“请在此处键入”编辑框中输入主菜单项“文件”,然后在“文件”菜单项的下一级依次输入子菜单项:“新建”、“打开”“保存”“另存为”,在子菜单项“另存为”下面的编辑框中右键插入分隔符,然后继续添加子菜单项“退出”,如原书的图6.3所示。
单击主菜单项“文件”的作用是弹出子菜单项列表,而不是执行程序命令,因此主菜单项“文件”是没有菜单项ID(或者说命令ID)的。我们依次将子菜单项新建、打开、保存、另存为、退出的菜单项ID修改为见名知义的名字:ID_FILE_NEW、ID_FILE_OPEN、ID_FILE_SAVE、ID_FILE_SAVEAS、ID_FILE_EXIT。
继续在主菜单项“文件”右边的“请在此处键入”编辑框中添加主菜单项“编辑”,以及子菜单项“剪切”“复制”“粘贴”;然后添加主菜单项“帮助”及子菜单项“关于HelloWindows”,分别设置子菜单项剪切、复制、粘贴和关于HelloWindows的ID为ID_EDIT_CUT、ID_EDIT_COPY、ID_EDIT_PASTE和ID_HELP_ABOUT,然后按Ctrl + S组合键保存资源脚本文件HelloWindows.rc,如原书的图6.4所示。
打开Chapter6\HelloWindows\HelloWindows,可以看到VS软件自动为我们创建了HelloWindows.rc和resource.h两个文件。HelloWindows.rc是资源脚本文件,除了VS的可视化资源编辑视图(资源编辑器),我们也可以通过自己编写资源脚本文件来添加资源。切换到解决方案资源管理器视图,用鼠标右键单击资源文件下面的HelloWindows.rc并查看代码,HelloWindows.rc文件的主要内容如下所示:
#include "resource.h"
IDR_MENU MENU
BEGIN
POPUP "文件"
BEGIN
MENUITEM "新建", ID_FILE_NEW
MENUITEM "打开", ID_FILE_OPEN
MENUITEM "保存", ID_FILE_SAVE
MENUITEM "另存为", ID_FILE_SAVEAS
MENUITEM SEPARATOR
MENUITEM "退出", ID_FILE_EXIT
END
POPUP "编辑"
BEGIN
MENUITEM "剪切", ID_EDIT_CUT
MENUITEM "复制", ID_EDIT_COPY
MENUITEM "粘贴", ID_EDIT_PASTE
END
POPUP "帮助"
BEGIN
MENUITEM "关于HelloWindows", ID_HELP_ABOUT
END
END
resource.h头文件的主要内容如下所示:
// Microsoft Visual C++ 生成的包含文件
// 供 HelloWindows.rc 使用
#define IDR_MENU 101
#define ID_FILE_NEW 40010
#define ID_FILE_OPEN 40011
#define ID_FILE_SAVE 40012
#define ID_FILE_SAVEAS 40013
#define ID_FILE_EXIT 40014
#define ID_EDIT_CUT 40015
#define ID_EDIT_COPY 40016
#define ID_EDIT_PASTE 40017
#define ID_HELP_ABOUT 40018
因为以后我们可能会学习软件DIY(Do It Yourself),比如为程序添加一个菜单项、修改版权信息等,这些都通过修改资源来实现。虽然不要求自己写出资源脚本文件,但是对于各种资源的定义方法我们应该了解。
资源脚本文件中包含了resource.h头文件,resource.h头文件中包含菜单资源和子菜单项的ID定义等。资源在程序中的引用往往用一个数值来表示,但是直接使用数值不直观,往往用#define语句将数值定义为容易记忆和理解的常量。
在资源脚本文件中菜单的定义格式如下:
菜单ID MENU
BEGIN
菜单定义
……
END
“菜单ID MENU”语句用来指定菜单资源的ID。菜单ID是一个16位的整数,范围是1~65535,本例中定义的菜单ID是IDR_MENU(101)。
菜单ID也可以用字符串来表示,例如下面的定义:
MainMenu MENU
BEGIN
菜单定义
……
END
表示菜单资源的ID是字符串类型的“MainMenu”。
菜单的具体定义语句包含在BEGIN和END关键字之内,这两个关键字也可以用{}代替。
弹出菜单的定义方式如下:
POPUP 菜单文字 [,选项列表]
BEGIN
子菜单项定义
……
END
菜单文字指主菜单项名称字符串,BEGIN和END关键字中的内容定义弹出菜单的每一个子菜单项。主菜单通常由多个主菜单项及下面的弹出菜单组成,本例中主菜单由“文件”“编辑”和“帮助”3个主菜单项及下面的弹出菜单组成。弹出菜单的定义也可以嵌套,以达到单击子菜单项弹出下一级子菜单项列表的目的,子弹出菜单的定义同样需要POPUP、BEGIN和END关键字。
常用的选项值如下:
-
GRAYED——菜单项是灰化的;
-
INACTIVE——菜单项是禁用的。
有些选项是可以同时定义的,各个选项之间用逗号隔开,例如“POPUP “文件”, HELP, INACTIVE”表示主菜单项“文件”和以后的主菜单项是右对齐的,并且主菜单项“文件”是禁用的。
子菜单项的定义方式如下:
MENUITEM 菜单文字 命令ID [,选项列表]
-
菜单文字指子菜单项名称字符串。有时候在字符串的后面需要加一个带下划线的字母,例如“打开(O)”,可以在字母前面加“&”符号,即“打开(&O)”。带下划线的字母称为访问键,例如本例中当“文件”弹出菜单打开的时候按下O键,那么就相当于用鼠标单击了子菜单项“打开”,在同一个弹出菜单中不同的子菜单项所用的访问键必须不同。 另外,要使加速键的提示信息显示在子菜单项的右边,例如子菜单项“打开”可以使用Ctrl + O组合键,可以加一个\t(表示插入一个Tab字符),然后写上“Ctrl + O”,即“打开(&O)\tCtrl + O”,这样\t后面的字符会右对齐显示。
-
命令ID用于区分不同的子菜单项。当单击子菜单项的时候,系统会向窗口过程发送WM_COMMAND消息,消息的LOWORD(wParam)就是这个命令ID,通过命令ID可以区分用户到底单击了哪一个子菜单项,以作出不同的处理。
-
选项列表用来定义子菜单项的各种属性,常用的值如表6.1所示。
表6.1
| 选项 | 含义 |
|---|---|
| CHECKED | 表示在菜单项前面打上选定标志(对钩),也就是复选标志。选定标志还包括类似单选按钮的圆圈标志,但是在菜单资源中设置选定标志以后,菜单项前面显示的是复选标志对钩,而不是单选标志圆圈 |
| GRAYED | 表示菜单项是灰化的 |
| INACTIVE | 表示菜单项是禁用的 |
| MENUBREAK | 表示将这个菜单项和以后的菜单项放到新的一行(主菜单中的菜单项)或一列(子菜单项)中,行与行之间没有分隔线,列与列之间也没有分隔线 |
| MENUBARBREAK | 表示将这个菜单项和以后的菜单项放到新的一行(主菜单中的菜单项)或一列(子菜单项)中,行与行之间没有分隔线,列与列之间有分隔线 |
子菜单项之间的分隔线的定义方式如下:
MENUITEM SEPARATOR
分隔线不需要命令ID和属性选项。
通过前面所学,手动修改资源脚本文件内容为如下形式:
IDR_MENU MENU
BEGIN
POPUP "文件"
BEGIN
MENUITEM "新建(&N)\tCtrl+N", ID_FILE_NEW
MENUITEM "打开(&O)\tCtrl+O", ID_FILE_OPEN
MENUITEM "保存(&S)\tCtrl+S", ID_FILE_SAVE, CHECKED, MENUBREAK
MENUITEM "另存为(&A)", ID_FILE_SAVEAS
MENUITEM SEPARATOR
MENUITEM "退出(&X)", ID_FILE_EXIT
END
POPUP "编辑", INACTIVE
BEGIN
MENUITEM "剪切(&T)\tCtrl+X", ID_EDIT_CUT
MENUITEM "复制(&C)\tCtrl+C", ID_EDIT_COPY
MENUITEM "粘贴(&P)\tCtrl+V", ID_EDIT_PASTE
END
POPUP "帮助", HELP
BEGIN
MENUITEM "关于HelloWindows(&A)", ID_HELP_ABOUT
END
END
为各子菜单项设置访问键;为子菜单项新建、打开、保存、剪切、复制、粘贴分别设置加速键提示信息;在弹出菜单“文件”中子菜单项“保存”的前面设置一个复选标记,并把该子菜单项及以后的子菜单项放到新的一列中;禁用弹出菜单“编辑”;将弹出菜单“帮助”设置到菜单栏右侧。实际上,这些属性的设置完全可以通过VS资源编辑器的属性对话框来设置,在此只是为了练习一下书写资源脚本文件。
除此之外,VS的属性对话框中还有Right Justify(右对齐)和Right Order(从右到左显示)等菜单项属性,Right Order属性一般用不到。在设置子菜单项“新建”为Right Order属性以后,资源脚本文件发生了变化:
IDR_MENU MENUEX
BEGIN
POPUP "文件", 65535,MFT_STRING,MFS_ENABLED
BEGIN
MENUITEM "新建(&N)\tCtrl+N", ID_FILE_NEW,MFT_STRING | MFT_RIGHTORDER,MFS_ENABLED
MENUITEM "打开(&O)\tCtrl+O", ID_FILE_OPEN,MFT_STRING, MFS_ENABLED
MENUITEM "保存(&S)\tCtrl+S", ID_FILE_SAVE,MFT_STRING | MFT_MENUBREAK,MFS_CHECKED
MENUITEM "另存为(&A)", ID_FILE_SAVEAS,MFT_STRING, MFS_ENABLED
MENUITEM MFT_SEPARATOR
MENUITEM "退出(&X)", ID_FILE_EXIT,MFT_STRING, MFS_ENABLED
END
POPUP "编辑", 65535,MFT_STRING,MFS_GRAYED
BEGIN
MENUITEM "剪切(&T)\tCtrl+X", ID_EDIT_CUT,MFT_STRING, MFS_ENABLED
MENUITEM "复制(&C)\tCtrl+C", ID_EDIT_COPY,MFT_STRING, MFS_ENABLED
MENUITEM "粘贴(&P)\tCtrl+V", ID_EDIT_PASTE,MFT_STRING, MFS_ENABLED
END
POPUP "帮助", 65535,MFT_STRING | MFT_RIGHTJUSTIFY,MFS_ENABLED
BEGIN
MENUITEM "关于HelloWindows(&A)", ID_HELP_ABOUT,MFT_STRING, MFS_ENABLED
END
END
菜单的定义格式变为IDR_MENU MENUEX,这是扩展菜单的定义语句,各菜单项的属性值也变为另一种写法,其中MFT_*表示类型标志,MFS_*表示状态标志。这都很好理解,后面会介绍扩展菜单的一些用法。现在,通过资源脚本文件手动去掉子菜单项“新建”的MFT_RIGHTORDER标志。
我们为HelloWindows程序添加菜单栏。制作好菜单资源以后,为一个程序窗口添加菜单栏很简单,首先需要在HelloWindows.cpp源文件中包含resource.h头文件:#include “resource.h”。
第一种方法是设置WNDCLASSEX结构的lpszMenuName字段,该字段是LPCTSTR类型,可以使用MAKEINTRESOURCE宏,例如:
wndclass.lpszMenuName = MAKEINTRESOURCE(IDR_MENU);
MAKEINTRESOURCE宏在WinUser.h头文件中定义如下:
#define MAKEINTRESOURCEA(i) ((LPSTR)((ULONG_PTR)((WORD)(i))))
#define MAKEINTRESOURCEW(i) ((LPWSTR)((ULONG_PTR)((WORD)(i))))
#ifdef UNICODE
#define MAKEINTRESOURCE MAKEINTRESOURCEW
#else
#define MAKEINTRESOURCE MAKEINTRESOURCEA
#endif
第二种方法是在创建窗口的CreateWindowEx函数中指定hMenu参数,例如:
HMENU hMenu;
hMenu = LoadMenu(hInstance, MAKEINTRESOURCE(IDR_MENU));
hwnd = CreateWindowEx(0, szClassName, szAppName, WS_OVERLAPPEDWINDOW,
CW_USEDEFAULT, CW_USEDEFAULT, 400, 300, NULL, hMenu, hInstance, NULL);
LoadMenu函数用于从与应用程序实例关联的可执行模块中加载指定的菜单资源:
HMENU WINAPI LoadMenu(
_In_opt_ HINSTANCE hInstance, // 要加载的菜单资源所属的模块句柄
_In_ LPCTSTR lpMenuName); // 菜单资源名称
HMENU是菜单句柄类型,函数执行成功,返回值是菜单资源的句柄。
第三种方法是使用SetMenu函数为指定窗口设置菜单:
case WM_CREATE:
hMenu = LoadMenu(g_hInstance, MAKEINTRESOURCE(IDR_MENU));
SetMenu(hwnd, hMenu);
return 0;
g_hInstance是一个全局变量,表示可执行模块句柄,在WinMain函数中赋值:g_hInstance = hInstance;。
SetMenu函数原型如下:
BOOL WINAPI SetMenu(
_In_ HWND hWnd, // 窗口句柄
_In_opt_ HMENU hMenu); // 菜单句柄,设置为NULL表示删除窗口的当前菜单
实际上这种方法很好,如果程序是多语言版本,我们可以为每种语言创建一个菜单资源,在用户选择了不同的语言以后,动态更换菜单资源。调用SetMenu设置了新菜单资源以后,应该调用DestroyMenu(hMenu)函数销毁上一个菜单资源(如果存在上一个菜单资源)。
添加菜单以后的HelloWindows程序运行效果如原书的图6.5所示。
在Chapter6\HelloWindows\HelloWindows\Debug下可以看到生成了HelloWindows.res文件,这是资源编译器编译资源脚本文件HelloWindows.rc后得到的二进制资源文件,目标文件*.obj和资源文件*.res最后通过链接器链接成可执行文件。资源文件*.res也可以通过VS的资源编辑器进行编辑。资源虽然被一起打包到可执行文件中,但是资源不在可执行文件的数据区,在程序中无法使用变量或地址直接对资源进行引用。Windows提供了各种函数对资源进行加载,例如LoadMenu、LoadIcon、LoadCursor、LoadAccelerators等,这些函数加载的资源通常不需要释放,程序退出时由系统释放,程序自己创建的对象在不需要的时候通常需要释放,而程序或系统中定义的资源通常不需要释放。
当用户单击某一子菜单项(命令项)时,则系统会向拥有该菜单的窗口发送WM_COMMAND消息;如果单击的是系统菜单的子菜单项,则发送WM_SYSCOMMAND消息,程序通常不需要处理WM_SYSCOMMAND消息,而是交给DefWindowProc函数执行默认处理。
6.1.2 加速键
加速键也称为键盘快捷键,一个加速键是一个或几个按键的组合。加速键用于激活特定的子菜单项命令,通过使用加速键不需要费力移动鼠标就能激活子菜单项。
前面为HelloWindows程序制作菜单资源的时候,已经为子菜单项新建、打开、保存、剪切、复制、粘贴设置了加速键提示信息,还需要添加加速键资源把加速键和菜单命令建立关联。打开VS资源视图,用鼠标右键单击HelloWindows项目,然后选择添加→资源,打开添加资源对话框,选择Accelerator,单击新建,如原书的图6.6所示。
可以看到,VS自动在HelloWindows.rc文件中添加了类型为Accelerator的加速键表IDR_ACCELERATOR1。选中左侧的IDR_ACCELERATOR1,打开右侧的属性对话框,可以修改加速键表的ID。
单击资源编辑器中ID一列的ID_ACCELERATOR40032两次,出现下拉框,可以看到刚才添加的子菜单项的ID都在里面。选择ID_FILE_NEW,子菜单项新建的快捷键是Ctrl + N,因此选择第二列的修饰符为Ctrl,第三列是按键的虚拟键码或ASCII,直接输入字母N,然后第四列的类型选择虚拟键码VIRTKEY,如原书的图6.7所示。
同样的方法,为其他子菜单项添加快捷键关联,但是为剪切、复制、粘贴的按键类型选择ASCII(第四列的类型),最后如原书的图6.8所示。
按Ctrl + S组合键保存HelloWindows.rc文件。
打开HelloWindows.rc文件,看一下新添加的加速键资源:
IDR_ACC ACCELERATORS
BEGIN
"N", ID_FILE_NEW, VIRTKEY, CONTROL, NOINVERT
"O", ID_FILE_OPEN, VIRTKEY, CONTROL, NOINVERT
"S", ID_FILE_SAVE, VIRTKEY, CONTROL, NOINVERT
"^X", ID_EDIT_CUT, ASCII, NOINVERT
"^C", ID_EDIT_COPY, ASCII, NOINVERT
"^P", ID_EDIT_PASTE, ASCII, NOINVERT
END
resource.h头文件的部分内容如下所示:
#define IDR_MENU 101
#define IDR_ACC 102
#define ID_FILE_NEW 40010
与菜单的定义相比,加速键的定义要简单得多,语法如下:
加速键ID ACCELERATORS
BEGIN
键名, 菜单命令ID [,类型] [,修饰符]
……
END
加速键ID同样可以是一个字符串或1~65535之间的数字,加速键的具体定义内容包含在BEGIN和END(或{})关键字之内,中间是各个加速键的定义,每个加速键占据一行。
-
键名,表示加速键对应的按键,有3种方式定义。
-
“大写字母”:类型指定为VIRTKEY,表示字母键。
-
“^大写字母”:类型指定为ASCII,表示Ctrl键加上字母键。
-
“大写字母或小写字母或ASCII值”:类型指定为ASCII,表示字母键。
-
建议使用方式1,不建议指定类型为ASCII。
例1:“a”, ID_HELP_ABOUT, ASCII, NOINVERT
例2:“A”, ID_HELP_ABOUT, ASCII, NOINVERT
例3:“A”, ID_HELP_ABOUT, VIRTKEY, NOINVERT
例1中,只有按下小写字母a才可以,例2只有按下大写字母A才可以(同时按下Shift或CapsLock键),例3按下小写字母a或大写字母A都可以。
-
菜单命令ID。如果想把加速键和子菜单项关联起来,就需要指定为关联菜单项的命令ID。
-
类型。可以是VIRTKEY或ASCII,分别用来表示“键名”字段定义的是虚拟键码还是ASCII码。
-
修饰符。可以是Control、Shift或Alt中的一个或多个,如果指定多个,则中间用逗号隔开,表示加速键是键名指定的按键加上这些键的组合键。
现在我们手动为“帮助”主菜单项下面的“关于HelloWindows”添加Ctrl + Shift + A快捷键:
IDR_ACC ACCELERATORS
BEGIN
"N", ID_FILE_NEW, VIRTKEY, CONTROL, NOINVERT
"O", ID_FILE_OPEN, VIRTKEY, CONTROL, NOINVERT
"S", ID_FILE_SAVE, VIRTKEY, CONTROL, NOINVERT
"^X", ID_EDIT_CUT, ASCII, NOINVERT
"^C", ID_EDIT_COPY, ASCII, NOINVERT
"^P", ID_EDIT_PASTE, ASCII, NOINVERT
"A", ID_HELP_ABOUT, VIRTKEY, CONTROLL, SHIFT, NOINVERT
END
在一个资源脚本文件中,可以定义多个主菜单或多个加速键表,也可以定义其他各种各样的资源,例如图标、光标、位图等,这就涉及如何为这些资源取ID值的问题,取值的时候要掌握的原则如下。
(1)对于同类别内的多个资源项,各项的ID必须为不同的值。假设定义了两个子菜单项,那么它们的ID就必须用不同的数值来表示,否则系统将无法分辨。
(2)对于不同类别的资源,资源项ID在数值上可以是相同的,例如某子菜单项的ID为40010,那么也可以同时有ID为40010的位图或图标等,Windows可以按类别分清每一项。
有两种加速键表,系统维护一个可以用于所有应用程序的系统范围的加速键表,应用程序无法修改系统加速键表,例如“Alt + 空格”打开系统菜单,“Alt + F4”关闭程序,“Ctrl + Esc”打开系统开始菜单,“Alt + PrintScreen”将活动窗口中的图像复制到剪贴板,按键“PrintScreen”将屏幕上的图像复制到剪贴板等。系统还为每个应用程序维护加速键表。应用程序可以定义任意数量的加速键表,并随时更换活动加速键表。如果应用程序也定义了在系统加速键表中定义的加速键,则应用程序定义的加速键将覆盖系统的加速键,请避免这种做法。
要处理用户按下的加速键,程序需要在消息循环中调用TranslateAccelerator函数。该函数会监视消息队列中的WM_KEYDOWN和WM_KEYUP消息,以检查是否有与加速键表中相匹配的击键组合。如果有,就会将其转换为WM_COMMAND或WM_SYSCOMMAND(按下的是系统菜单中的加速键)消息,然后将该消息发送到窗口的窗口过程。
要调用TranslateAccelerator函数,就要先调用LoadAccelerators函数加载加速键表:
HACCEL WINAPI LoadAccelerators(
_In_opt_ HINSTANCE hInstance, // 要加载的加速键表所属的模块句柄
_In_ LPCTSTR lpTableName); // 要加载的加速键表的名称,可以使用MAKEINTRESOURCE宏
HACCEL是加速键表句柄类型,函数执行成功,返回指定的加速键表句柄。
TranslateAccelerator函数原型如下:
int WINAPI TranslateAccelerator(
_In_ HWND hWnd, // 要处理哪个窗口的消息
_In_ HACCEL hAccTable,// LoadAccelerators函数加载或CreateAcceleratorTable函数创建的加速
// 键表句柄
_In_ LPMSG lpMsg); // 消息结构
如果有消息被转换,则系统将WM_COMMAND或WM_SYSCOMMAND消息发送到窗口的窗口过程。窗口过程处理完WM_COMMAND或WM_SYSCOMMAND消息以后,TranslateAccelerator函数返回非零值,否则返回值为0。如果TranslateAccelerator函数返回非零值,就不应该再调用TranslateMessage和DispatchMessage函数(因为消息已经处理),而是应该继续下一次GetMessage消息的获取。消息循环的写法通常按如下方式:
HACCEL hAccel = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDR_ACC));
while (GetMessage(&msg, NULL, 0, 0) != 0)
{
if (!TranslateAccelerator(hwnd, hAccel, &msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
消息结构(MSG)有一个hwnd字段,为什么TranslateAccelerator函数还有一个hWnd参数呢?MSG结构由GetMessage函数填充。当GetMessage的第2个参数是NULL时,该函数获取属于应用程序主线程的所有窗口的消息,当GetMessage函数返回时,MSG结构的hwnd字段是将会得到该消息的窗口的窗口句柄。然而,当TranslateAccelerator函数将键盘消息转换成WM_COMMAND或WM_SYSCOMMAND消息时,它将msg.hwnd字段替换成TranslateAccelerator函数第1个参数所指定的窗口句柄,于是Windows会将所有加速键消息发送给指定的窗口。如果程序有多个窗口,则每个窗口都有可能收到键盘消息;如果不是这种设计,就需要在每个窗口的窗口过程中处理加速键消息。所以一般把所有的加速键消息都发送到主窗口,集中在主窗口的窗口过程中处理WM_COMMAND或WM_SYSCOMMAND消息,这有利于精简代码。
- WM_COMMAND消息的wParam和lParam参数如表6.2所示。
表6.2
| 从哪发送过来的消息 | HIWORD(wParam) | LOWORD(wParam) | lParam |
|---|---|---|---|
| 菜单命令项 | 0 | 菜单项ID | 0 |
| 加速键 | 1 | 菜单项ID | 0 |
| 子窗口控件 | 通知码 | 控件ID | 控件句柄 |
后面再讲子窗口控件的命令消息。通常,不在乎是菜单命令项还是加速键发送过来的WM_COMMAND消息,也就是不用区分HIWORD(wParam),只需要区分LOWORD(wParam)来根据不同的菜单项ID作出不同的处理。
当用户单击了系统菜单中的命令项或按下了系统菜单的加速键,又或者单击了最小化、最大化、恢复、关闭按钮时,窗口过程会收到WM_SYSCOMMAND消息。程序通常不应该处理WM_SYSCOMMAND消息,而是交给DefWindowProc函数执行默认处理。
- WM_SYSCOMMAND消息的wParam参数包含请求的系统命令类型,常见的值如表6.3所示。
表6.3
| 常量 | 值 | 含义 |
|---|---|---|
| SC_MINIMIZE | 0xF020 | 最小化窗口 |
| SC_MAXIMIZE | 0xF030 | 最大化窗口 |
| SC_RESTORE | 0xF120 | 将窗口恢复到正常位置和大小 |
| SC_CLOSE | 0xF060 | 关闭窗口 |
| SC_SIZE | 0xF000 | 调整窗口大小 |
| SC_MOVE | 0xF010 | 移动窗口 |
| SC_HSCROLL | 0xF080 | 水平滚动 |
| SC_VSCROLL | 0xF070 | 垂直滚动 |
| SC_HOTKEY | 0xF150 | 全局热键消息 |
可以看到系统命令类型实际上使用的是LOWORD(wParam)。请注意,wParam参数的最低4位由系统内部使用,因此如果想测试wParam参数的值,则应该使用wParam & 0xFFF0来得到正确的结果。如果程序需要处理WM_SYSCOMMAND消息,则在处理完感兴趣的系统命令以后,其余部分必须转交给DefWindowProc函数执行默认处理。
- 如果用户使用鼠标选择系统菜单命令项,lParam参数的低位字表示鼠标光标的X坐标,高位字表示Y坐标(屏幕坐标),可以使用GET_X_LPARAM(lParam)和GET_Y_LPARAM(lParam)宏来分别提取鼠标光标的X和Y坐标。 关于菜单,还有许多知识点没有讲解。现在让我们先练习一下前面所学的吧,为HelloWindows程序添加菜单和加速键:
#include <Windows.h>
#include <tchar.h>
#include "resource.h"
// 全局变量
HINSTANCE g_hInstance;
// 函数声明,窗口过程
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam);
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int
nCmdShow)
{
WNDCLASSEX wndclass;
TCHAR szClassName[] = TEXT("MyWindow");
TCHAR szAppName[] = TEXT("HelloWindows");
HWND hwnd;
MSG msg;
g_hInstance = hInstance;
wndclass.cbSize = sizeof(WNDCLASSEX);
wndclass.style = CS_HREDRAW | CS_VREDRAW;
wndclass.lpfnWndProc = WindowProc;
wndclass.cbClsExtra = 0;
wndclass.cbWndExtra = 0;
wndclass.hInstance = hInstance;
wndclass.hIcon = LoadIcon(NULL, IDI_APPLICATION);
wndclass.hCursor = LoadCursor(NULL, IDC_ARROW);
wndclass.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH);
wndclass.lpszMenuName = NULL;
wndclass.lpszClassName = szClassName;
wndclass.hIconSm = NULL;
RegisterClassEx(&wndclass);
hwnd = CreateWindowEx(0, szClassName, szAppName, WS_OVERLAPPEDWINDOW,
CW_USEDEFAULT, CW_USEDEFAULT, 400, 300, NULL, NULL, hInstance, NULL);
ShowWindow(hwnd, nCmdShow);
UpdateWindow(hwnd);
HACCEL hAccel = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDR_ACC));
while (GetMessage(&msg, NULL, 0, 0) != 0)
{
if (!TranslateAccelerator(hwnd, hAccel, &msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
return msg.wParam;
}
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
HMENU hMenu;
TCHAR szBuf[64] = { 0 };
switch (uMsg)
{
case WM_CREATE:
hMenu = LoadMenu(g_hInstance, MAKEINTRESOURCE(IDR_MENU));
SetMenu(hwnd, hMenu);
return 0;
case WM_COMMAND:
switch (LOWORD(wParam))
{
case ID_FILE_NEW: // 新建
wsprintf(szBuf, TEXT("您单击了 新建 菜单项,命令ID:%d\n"), ID_FILE_NEW);
MessageBox(hwnd, szBuf, TEXT("提示"), MB_OK);
break;
case ID_EDIT_CUT: // 剪切
wsprintf(szBuf, TEXT("您单击了 剪切 菜单项,命令ID:%d\n"), ID_EDIT_CUT);
MessageBox(hwnd, szBuf, TEXT("提示"), MB_OK);
break;
case ID_HELP_ABOUT: // 关于HelloWindows
wsprintf(szBuf, TEXT("您单击了 关于HelloWindows菜单项,命令ID:%d\n"), ID_HELP_ABOUT);
MessageBox(hwnd, szBuf, TEXT("提示"), MB_OK);
break;
case ID_FILE_EXIT: // 退出
wsprintf(szBuf, TEXT("您单击了 退出 菜单项,命令ID:%d\n"), ID_FILE_EXIT);
MessageBox(hwnd, szBuf, TEXT("提示"), MB_OK);
SendMessage(hwnd, WM_CLOSE, 0, 0);
break;
}
return 0;
case WM_SYSCOMMAND:
switch (wParam & 0xFFF0)
{
case SC_CLOSE:
MessageBox(hwnd, TEXT("您单击了 系统菜单 关闭 菜单项"), TEXT("提示"), MB_OK);
SendMessage(hwnd, WM_CLOSE, 0, 0);
break;
default:
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
return 0;
case WM_DESTROY:
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
具体代码参见Chapter6\HelloWindows项目,程序仅演示了新建、剪切、关于HelloWindows和退出这几个子菜单项的处理,以及对系统菜单项“关闭”的处理。
6.1.3 菜单的查询、创建、添加、修改和删除
前面的菜单资源(也叫菜单模板)是通过资源编辑器或编写资源脚本文件创建的,程序还可以随时动态创建菜单模板,调用LoadMenuIndirect函数加载菜单模板得到菜单句柄,然后可以通过调用SetMenu函数为窗口设置新的菜单:
HMENU LoadMenuIndirect(_In_ const MENUTEMPLATE *lpMenuTemplate);// 指向菜单模板或扩展菜单
// 模板的指针
参数lpMenuTemplate是指向菜单模板或扩展菜单模板的指针。菜单模板由一个MENUITEMTEMPLATEHEADER结构和一个或多个连续的MENUITEMTEMPLATE结构组成,扩展菜单模板由一个MENUEX_TEMPLATE_HEADER结构和一个或多个连续的MENUEX_TEMPLATE_ITEM结构组成。MENUITEMTEMPLATEHEADER或MENUEX_TEMPLATE_HEADER结构定义菜单模板的头部,MENUITEMTEMPLATE或MENUEX_TEMPLATE_ITEM结构定义子菜单项。一个菜单模板由一个头部和一个或多个子菜单项组成。
MENUITEMTEMPLATEHEADER结构在WinUser.h头文件中定义如下:
typedef struct {
WORD versionNumber; // 菜单模板版本号,必须为0
WORD offset; // 通常设置为0
} MENUITEMTEMPLATEHEADER, *PMENUITEMTEMPLATEHEADER;
MENUITEMTEMPLATE结构在WinUser.h头文件中定义如下:
typedef struct {
WORD mtOption; // 菜单选项
WORD mtID; // 菜单ID
WCHAR mtString[1]; // 菜单名称
} MENUITEMTEMPLATE, *PMENUITEMTEMPLATE;
- mtOption字段指定菜单选项,常用的值如表6.4所示。
表6.4
| 常量 | 含义 |
|---|---|
| MF_POPUP | 弹出菜单 |
| MF_CHECKED | 菜单项旁边有复选标记 |
| MF_GRAYED | 菜单项处于灰化或禁用状态 |
| MF_MENUBREAK | 该菜单项及后面的菜单项位于新行或新列中 |
| MF_MENUBARBREAK | 该菜单项及后面的菜单项位于新行或新列中,列与列之间有分隔线 |
| MF_HELP | 该菜单项和以后的菜单项是右对齐的 |
| MF_OWNERDRAW | 默认情况下,菜单项都是由系统负责绘制的,指定MF_OWNERDRAW选项表示该菜单项由程序自己负责绘制 |
此外,可用的菜单选项还有MF_STRING、MF_POPUP、MF_HILITE等。
-
mtID字段指定菜单项ID,弹出菜单不需要指定该字段。
-
mtString字段指定菜单名称,是WCHAR类型数组。请注意,不管程序使用Unicode还是ANSI字符集,程序资源中的字符串都是使用Unicode编码。
先举一个菜单模板的例子,下例中当用户按下一个按键的时候就切换菜单栏:
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
HMENU hMenu;
WORD arrMenuTemplate[] = {
// MENUITEMTEMPLATEHEADER结构
0,
0,
// 多个MENUITEMTEMPLATE结构
// 第1个弹出菜单, 最后一个子菜单项需要MF_HILITE标志
MF_STRING | MF_POPUP, L'编', L'辑', 0,
MF_STRING, 40030, L'剪', L'切', L'(', L'&', L'T', L')', L'\t', L'C', L't', L'r',
L'l', L'+', L'X', 0,
MF_STRING, 40031, L'复', L'制', L'(', L'&', L'C', L')', L'\t', L'C', L't', L'r',
L'l', L'+', L'C', 0,
MF_STRING, 40032, L'粘', L'贴', L'(', L'&', L'P', L')', L'\t', L'C', L't', L'r',
L'l', L'+', L'V', 0,
MF_SEPARATOR, 0, 0,
MF_STRING, 40033, L'红', L'色', L'(', L'&', L'R', L')', 0,
MF_STRING, 40034, L'绿', L'色', L'(', L'&', L'G', L')', 0,
MF_STRING | MF_HILITE, 40035, L'蓝', L'色', L'(', L'&', L'B', L')', 0,
// 第2个弹出菜单, 最后一个子菜单项需要MF_HILITE标志
MF_STRING | MF_POPUP, L'视', L'图', 0,
MF_STRING, 40036, L'大', L'图', L'标', L'(', L'&', L'D', L')', 0,
MF_STRING | MF_HILITE, 40037, L'小', L'图', L'标', L'(', L'&', L'S', L')', 0,
// 第3个弹出菜单, 开始和结束都需要MF_HILITE标志,说明这是最后一个弹出菜单
MF_STRING | MF_POPUP | MF_HELP | MF_HILITE, L'帮', L'助', 0,
MF_STRING | MF_HILITE, 40038, L'关', L'于', L'H', L'e', L'l', L'l', L'o', L'W',
L'i', L'n', L'd', L'o', L'w', L's', L'(', L'&', L'A', L')', 0
};
switch (uMsg)
{
case WM_CREATE:
hMenu = LoadMenu(g_hInstance, MAKEINTRESOURCE(IDR_MENU));
SetMenu(hwnd, hMenu);
return 0;
case WM_CHAR:
// 从内存中动态加载菜单资源(菜单模板)
hMenu = LoadMenuIndirect(arrMenuTemplate);
SetMenu(hwnd, hMenu);
return 0;
case WM_COMMAND:
switch (LOWORD(wParam))
{
case 40030:
MessageBox(hwnd, TEXT("按下了 剪切"), TEXT("提示"), MB_OK);
break;
case 40036:
MessageBox(hwnd, TEXT("按下了 大图标"), TEXT("提示"), MB_OK);
break;
case 40038:
MessageBox(hwnd, TEXT("按下了 关于HelloWindows"), TEXT("提示"), MB_OK);
break;
}
return 0;
case WM_DESTROY:
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
完整代码参见Chapter6\HelloWindows2项目。
有的收费软件,在用户注册成为正式版前,会让一些菜单项灰化,不可单击,或者干脆没有相应的菜单项,但是程序内部仍然实现了这个菜单项对应的功能,只要我们设法启用灰化的菜单项,或添加相应的菜单项即可。但是,如果试用版和正式版不是一个版本,试用版缺少相应菜单项对应的功能实现,就另当别论了。此外,有时候可能需要写一个程序去控制其他目标程序,这时需要向目标程序发送WM_COMMAND消息,LOWORD(wParam)参数被指定为目标程序的菜单项命令ID,因此学好菜单资源的相关操作是很重要的。
还可以通过调用CreateMenu函数创建一个空的菜单。该函数返回一个菜单句柄,然后调用AppendMenu或InsertMenu函数(或新版本的InsertMenuItem)向返回的菜单句柄添加菜单项:
HMENU CreateMenu(void); // 返回菜单句柄
BOOL WINAPI AppendMenu(
_In_ HMENU hMenu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ UINT uFlags, // 菜单选项
_In_ UINT_PTR uIDNewItem, // 菜单项ID或弹出菜单句柄
_In_opt_ LPCTSTR lpNewItem); // 菜单名称或位图句柄
参数uFlags指定菜单选项,可以是表6.5所示的值的组合。
表6.5
| 常量 | 含义 |
|---|---|
| MF_POPUP | 该菜单项用于弹出菜单。uIDNewItem参数被指定为弹出菜单的句柄,就是说要想添加一个可以弹出菜单的菜单项,需要准备一个弹出菜单句柄;lpNewItem参数被指定为指向菜单名称字符串的指针 |
| MF_STRING | 菜单项是文本字符串,lpNewItem参数被指定为指向菜单名称字符串的指针 |
| MF_BITMAP | 使用位图作为菜单项,lpNewItem参数被指定为位图的句柄 |
| MF_CHECKED | 在菜单项旁边显示一个复选标志 |
| MF_UNCHECKED | 菜单项旁边没有复选标志,这是默认情况 |
| MF_DISABLED | 禁用菜单项 |
| MF_ENABLED | 启用菜单项 |
| MF_GRAYED | 灰化菜单项 |
| MF_MENUBREAK | 该菜单项及后面的菜单项位于新行或新列中 |
| MF_MENUBARBREAK | 该菜单项及后面的菜单项位于新行或新列中,列与列之间有分隔线 |
| MF_OWNERDRAW | 该菜单项由程序自己负责绘制,lpNewItem参数可以指向自定义数据 |
| MF_SEPARATOR | 分隔符,uIDNewItem和lpNewItem参数将被忽略 |
如果uFlags参数没有指定MF_POPUP标志,那么uIDNewItem参数表示菜单项ID。
例1 假设程序窗口没有菜单栏,现在需要全新添加主菜单项及其弹出菜单:
hMenu = CreateMenu(); // 主菜单句柄
hMenuPopup = CreateMenu(); // 第1个弹出菜单句柄
AppendMenu(hMenuPopup, MF_STRING, ID_FILE_NEW, TEXT("新建"));
AppendMenu(hMenuPopup, MF_STRING, ID_FILE_OPEN, TEXT("打开"));
AppendMenu(hMenuPopup, MF_STRING, ID_FILE_SAVE, TEXT("保存"));
// 把第1个弹出菜单添加到主菜单,TEXT("文件")是菜单名称
AppendMenu(hMenu, MF_STRING | MF_POPUP, (UINT_PTR)hMenuPopup, TEXT("文件"));
hMenuPopup = CreateMenu(); // 第2个弹出菜单句柄
AppendMenu(hMenuPopup, MF_STRING, ID_EDIT_CUT, TEXT("剪切"));
AppendMenu(hMenuPopup, MF_STRING, ID_EDIT_COPY, TEXT("复制"));
AppendMenu(hMenuPopup, MF_STRING, ID_EDIT_PASTE, TEXT("粘贴"));
// 把第2个弹出菜单添加到主菜单,TEXT("编辑")是菜单名称
AppendMenu(hMenu, MF_STRING | MF_POPUP, (UINT_PTR)hMenuPopup, TEXT("编辑"));
SetMenu(hwnd, hMenu);
效果如原书的图6.9所示。
分别创建两个弹出菜单句柄,并为之添加子菜单项,然后把弹出菜单添加到主菜单(同时指定菜单名称),最后调用SetMenu函数显示到菜单栏。
例2 假设程序窗口已经有菜单栏,现在需要添加一个主菜单项及弹出菜单。HelloWindows程序主菜单中已经有文件、编辑和帮助这3个弹出菜单,我想再添加“视图”主菜单项,和“大图标”“小图标”子菜单项:
hMenu = GetMenu(hwnd); // 前面讲过,GetMenu函数用于获取一个窗口的菜单句柄
hMenuPopup = CreateMenu(); // 弹出菜单句柄
AppendMenu(hMenuPopup, MF_STRING, ID_VIEW_BIG, TEXT("大图标"));
AppendMenu(hMenuPopup, MF_STRING, ID_VIEW_SMALL, TEXT("小图标"));
AppendMenu(hMenu, MF_STRING | MF_POPUP, (UINT_PTR)hMenuPopup, TEXT("视图"));
DrawMenuBar(hwnd);
效果如原书的图6.10所示。
“视图”菜单项出现在右边,这是因为当初为“帮助”菜单项设置了右对齐,AppendMenu函数总是添加菜单项到指定主菜单或弹出菜单的末尾。在菜单更改以后需要调用DrawMenuBar函数强制刷新菜单栏。
例3 假设程序窗口已经有菜单栏,现在需要在一个弹出菜单中添加几个子菜单项。HelloWindows程序主菜单中已经有文件、编辑和帮助3个弹出菜单,我想在“编辑”菜单项中添加“红色”“绿色”“蓝色”子菜单项,再添加一个可以弹出子菜单项列表的子菜单项“更改大小写”,下面有“大写字母”和“小写字母”。当初禁用了主菜单项“编辑”,打开HelloWindows.rc资源脚本文件,手动去掉主菜单项“编辑”的MFS_GRAYED属性,如原书的图6.11所示。
hMenu = GetMenu(hwnd);
hMenuPopup = GetSubMenu(hMenu, 1);
AppendMenu(hMenuPopup, MF_SEPARATOR, NULL, NULL);
AppendMenu(hMenuPopup, MF_STRING, ID_EDIT_RED, TEXT("红色(&R)"));
AppendMenu(hMenuPopup, MF_STRING, ID_EDIT_GREEN, TEXT("绿色(&G)"));
AppendMenu(hMenuPopup, MF_STRING, ID_EDIT_BLUE, TEXT("蓝色(&B)"));
AppendMenu(hMenuPopup, MF_SEPARATOR, NULL, NULL);
hMenuPopupSub = CreateMenu();
AppendMenu(hMenuPopupSub, MF_STRING, ID_EDIT_UPPER, TEXT("大写字母(&U)"));
AppendMenu(hMenuPopupSub, MF_STRING, ID_EDIT_LOWER, TEXT("小写字母(&L)"));
AppendMenu(hMenuPopup, MF_STRING | MF_POPUP, (UINT_PTR)hMenuPopupSub, TEXT("更改大小写(&N)"));
GetSubMenu或GetMenuItemInfo函数可以获取弹出菜单或子菜单项的句柄:
HMENU WINAPI GetSubMenu(
_In_ HMENU hMenu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ int nPos); // 从0开始的相对位置
主菜单中最左侧的主菜单项位置为0,往右增加;弹出菜单中最顶部的菜单项位置为0,往下增加,分隔符也计算在内。在上面的示例中,主菜单中“文件”的位置为0,“编辑”的位置为1,因此使用GetSubMenu(hMenu, 1)获取的是“编辑”的弹出菜单句柄。
可以看出,AppendMenu函数把菜单项放到了最后,不能指定所放位置。InsertMenu函数也可以添加菜单项,但是可以指定插入的位置:
BOOL WINAPI InsertMenu(
_In_ HMENU hMenu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ UINT uPosition, // 新菜单项插入的位置,受uFlags参数的影响
_In_ UINT uFlags, // 菜单选项
_In_ UINT_PTR uIDNewItem, // 菜单项ID或弹出菜单句柄
_In_opt_ LPCTSTR lpNewItem); // 菜单名称或位图句柄
参数uFlags除了可以指定为AppendMenu函数的uFlags参数的那些选项,还可以是表6.6所示的值。
表6.6
| 常量 | 含义 |
|---|---|
| MF_BYCOMMAND | 默认值,表示uPosition参数指定的是某菜单项的ID,新菜单项将在其后 |
| MF_BYPOSITION | 表示uPosition参数指定的是新菜单项从0开始的相对位置,如果uPosition为−1,则新菜单项将插入菜单的末尾 |
除此之外,AppendMenu和InsertMenu函数的用法完全相同。
对于例2,在开始时使用AppendMenu函数,“视图”主菜单项出现在最右侧,现在改为:
hMenu = GetMenu(hwnd);
hMenuPopup = CreateMenu();
AppendMenu(hMenuPopup, MF_STRING, ID_VIEW_BIG, TEXT("大图标"));
AppendMenu(hMenuPopup, MF_STRING, ID_VIEW_SMALL, TEXT("小图标"));
InsertMenu(hMenu, 2, MF_STRING | MF_POPUP | MF_BYPOSITION, (UINT_PTR)hMenuPopup, TEXT("视图"));
DrawMenuBar(hwnd);
AppendMenu函数总是把菜单项放到最后,现在InsertMenu函数的uPosition参数指定为2表示放在第3个的位置。效果如原书的图6.12所示。
GetMenuItemID函数可以获取一个菜单项的ID:
UINT WINAPI GetMenuItemID(
_In_ HMENU hMenu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ int nPos); // 相对位置
函数执行成功,返回值是指定菜单项的ID。
GetMenuString函数可以获取一个菜单项的文本字符串:
int WINAPI GetMenuString(
_In_ HMENU hMenu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ UINT uIDItem, // 菜单项ID或相对位置
_Out_opt_ LPTSTR lpString, // 在lpString中返回菜单项的名称
_In_ int nMaxCount, // lpString缓冲区的大小,以字符为单位
_In_ UINT uFlag); // MF_BYCOMMAND或MF_BYPOSITION
如果函数执行成功,则返回值是复制到缓冲区中的字符数,不包括终止的空字符;如果函数执行失败,则返回值为0。
要修改一个菜单项,可以使用ModifyMenu函数:
BOOL WINAPI ModifyMenu(
_In_ HMENU hMnu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ UINT uPosition, // 菜单项ID或相对位置
_In_ UINT uFlags, // 菜单选项
_In_ UINT_PTR uIDNewItem, // 菜单项ID或弹出菜单句柄
_In_opt_ LPCTSTR lpNewItem); // 菜单名称或位图句柄
该函数的参数及含义和InsertMenu函数完全相同。
DeleteMenu和RemoveMenu函数都可以删除一个菜单项:
BOOL WINAPI DeleteMenu(HMENU hMenu, UINT uPosition, UINT uFlags);
BOOL WINAPI RemoveMenu(HMENU hMenu, UINT uPosition, UINT uFlags);
参数uFlags可以是MF_BYCOMMAND或MF_BYPOSITION。
另外,GetSystemMenu函数可以获取系统菜单的句柄,系统菜单也是一个弹出菜单:
HMENU WINAPI GetSystemMenu(
_In_ HWND hWnd, // 窗口句柄
_In_ BOOL bRevert); // TRUE或FALSE
如果bRevert参数设置为FALSE,则表示获取系统菜单的句柄。可以利用这个句柄对系统菜单中的菜单项进行修改,或者向系统菜单添加新的菜单项,所有预定义系统菜单项的ID都大于0xF000。如果程序需要向系统菜单添加菜单项,则菜单项ID必须小于0xF000;如果设置为TRUE,则表示将系统菜单恢复为默认状态。如果bRevert参数为FALSE,则GetSystemMenu函数返回值是系统菜单的句柄;如果bRevert参数为TRUE,则返回值为NULL。
前面说过,WM_SYSCOMMAND消息的wParam & 0xFFF0包含请求的系统命令类型,例如SC_CLOSE、SC_MOVE。如果在系统菜单中添加了菜单项,那么WM_SYSCOMMAND消息的LOWORD(wParam)就是菜单项ID。
例如,下面对系统菜单的操作:
// 灰化系统菜单的关闭菜单项
ModifyMenu(GetSystemMenu(hwnd, FALSE), SC_CLOSE, MF_GRAYED, SC_CLOSE, TEXT("关闭(&C)\ tAlt+F4"));
// 移除系统菜单的关闭菜单项
RemoveMenu(GetSystemMenu(hwnd, FALSE), SC_CLOSE, MF_BYCOMMAND);
// 在系统菜单后面添加一个“打开”菜单项
AppendMenu(GetSystemMenu(hwnd, FALSE), MF_STRING, ID_FILE_NEW, TEXT("打开(&O)"));
// 恢复系统菜单
GetSystemMenu(hwnd, TRUE);
6.1.4 菜单状态的设置、快捷菜单
为了接下来的测试,我在“编辑”主菜单项下添加了几个子菜单项和一个子弹出菜单,HelloWindows.rc文件的主要内容如下所示:
IDR_MENU MENUEX
BEGIN
POPUP "文件", 65535,MFT_STRING,MFS_ENABLED
BEGIN
MENUITEM "新建(&N)\tCtrl+N", ID_FILE_NEW,MFT_STRING, MFS_ENABLED
MENUITEM "打开(&O)\tCtrl+O", ID_FILE_OPEN,MFT_STRING, MFS_ENABLED
MENUITEM "保存(&S)\tCtrl+S", ID_FILE_SAVE,MFT_STRING, MFS_ENABLED
MENUITEM "另存为(&A)", ID_FILE_SAVEAS,MFT_STRING, MFS_ENABLED
MENUITEM MFT_SEPARATOR
MENUITEM "退出(&X)", ID_FILE_EXIT,MFT_STRING, MFS_ENABLED
END
POPUP "编辑", 65535,MFT_STRING,MFS_ENABLED
BEGIN
MENUITEM "剪切(&T)\tCtrl+X", ID_EDIT_CUT,MFT_STRING, MFS_ENABLED
MENUITEM "复制(&C)\tCtrl+C", ID_EDIT_COPY,MFT_STRING, MFS_ENABLED
MENUITEM "粘贴(&P)\tCtrl+V", ID_EDIT_PASTE,MFT_STRING, MFS_ENABLED
MENUITEM MFT_SEPARATOR
MENUITEM "红色(&R)", ID_EDIT_RED,MFT_STRING, MFS_ENABLED
MENUITEM "绿色(&G)", ID_EDIT_GREEN,MFT_STRING, MFS_ENABLED
MENUITEM "蓝色(&B)", ID_EDIT_BLUE,MFT_STRING, MFS_ENABLED
MENUITEM MFT_SEPARATOR
POPUP "更改大小写(&N)", 65535,MFT_STRING,MFS_ENABLED
BEGIN
MENUITEM "大写字母(&U)", ID_EDIT_UPPER,MFT_STRING, MFS_ENABLED
MENUITEM "小写字母(&L)", ID_EDIT_LOWER,MFT_STRING, MFS_ENABLED
END
END
POPUP "帮助", 65535,MFT_STRING | MFT_RIGHTJUSTIFY, MFS_ENABLED
BEGIN
MENUITEM "关于HelloWindows(&A)", ID_HELP_ABOUT,MFT_STRING, MFS_ENABLED
END
END
EnableMenuItem函数可以启用、禁用或灰化一个菜单项,实际上禁用和灰化效果是一样的:
BOOL WINAPI EnableMenuItem(
_In_ HMENU hMenu, // 菜单句柄
_In_ UINT uIDEnableItem,// 要启用、禁用或灰化的菜单项、菜单项ID或相对位置
_In_ UINT uEnable);
uEnable参数可以是MF_BYCOMMAND、MF_BYPOSITION、MF_ENABLED、MF_DISABLED、MF_GRAYED。
使用前面介绍的ModifyMenu函数也可以达到启用、禁用或灰化一个菜单项的目的,但是EnableMenuItem函数更简单一些。函数返回值是指定菜单项的先前状态(MF_ENABLED、MF_DISABLED或MF_GRAYED),如果菜单项不存在,则返回值为−1。更改菜单项以后菜单栏不会立即更新,可以调用DrawMenuBar函数强制刷新。
GetMenuState函数可以测试一个菜单项的状态:
UINT WINAPI GetMenuState(
_In_ HMENU hMenu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ UINT uId, // 菜单项ID或相对位置
_In_ UINT uFlags); // MF_BYCOMMAND或MF_BYPOSITION
函数执行成功,返回值是指定菜单项的菜单状态。如果菜单项是弹出菜单,则返回值的低位字节包含菜单状态,高位字节包含弹出菜单中的子菜单项个数;如果指定的菜单项不存在,则返回值为−1。菜单状态标志如表6.7所示。
表6.7
| 常量 | 含义 |
|---|---|
| MF_POPUP | 是弹出菜单 |
| MF_CHECKED | 表示在菜单项前面有选定标志(复选或单选标志) |
| MF_DISABLED | 菜单项处于禁用状态 |
| MF_GRAYED | 菜单项处于灰化状态 |
| MF_HILITE | 菜单项处于高亮显示状态 |
| MF_MENUBREAK | 菜单项在新行或新列中 |
| MF_MENUBARBREAK | 菜单项在新行或新列中,列与列之间有分隔线 |
| MF_OWNERDRAW | 是自绘菜单项 |
| MF_SEPARATOR | 是分隔线 |
但是,如何测试MF_ENABLED、MF_STRING、MF_UNCHECKED或MF_UNHILITE呢?这4个常量的值均为0,可以使用表6.8中的表达式。
表6.8
| 常量 | 表达式 |
|---|---|
| MF_ENABLED | !(返回值 & (MF_DISABLED |
| MF_STRING | !(返回值 & (MF_BITMAP |
| MF_UNCHECKED | !(返回值 & MF_CHECKED) |
| MF_UNHILITE | !(返回值 & MF_HILITE) |
例如:
hMenu = GetMenu(hwnd);
uiState = GetMenuState(hMenu, 1, MF_BYPOSITION); //“编辑”主菜单项
if (uiState & MF_POPUP)
{
wsprintf(szBuf, TEXT("%s 子菜单个数%d %s"), TEXT("是弹出菜单"), HIBYTE (uiState),
!(LOBYTE(uiState) & (MF_DISABLED | MF_GRAYED)) ? TEXT("启用状态") : TEXT("已禁用或灰化"));
MessageBox(hwnd, szBuf, TEXT("提示"), MB_OK);
}
效果如原书的图6.13所示。
CheckMenuItem函数可以为一个菜单项设置或取消复选标志:
DWORD WINAPI CheckMenuItem(
_In_ HMENU hmenu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ UINT uIDCheckItem,// 菜单项ID或相对位置
_In_ UINT uCheck); // 标志
参数uCheck可用的标志有MF_BYCOMMAND、MF_BYPOSITION、MF_CHECKED(设置复选)和MF_UNCHECKED(取消复选)。函数返回值是指定菜单项的先前状态(MF_CHECKED或MF_UNCHECKED)。如果菜单项不存在,则返回值为−1。主菜单中的主菜单项前面不能设置复选标志。
有时候,程序菜单项需要模仿一组单选按钮。在本节开头,我为资源文件添加了“红色”“绿色”“蓝色”3个子菜单项,以及一个“更改大小写”弹出菜单。假设我把红色、绿色、蓝色当作一组单选子菜单项,这几个菜单项应该在互斥的选定和非选定状态之间切换(前面是否有圆圈标志),同一时刻只有一个是可以选定的。当选定其中一个的时候,其他的都应该取消选定。CheckMenuRadioItem函数可以很方便地实现这个目的,该函数设置指定范围内的一组菜单项中的某个菜单项为选定状态,同时取消选定其他菜单项:
BOOL WINAPI CheckMenuRadioItem(
_In_ HMENU hmenu, // 包含菜单项组的菜单句柄
_In_ UINT idFirst, // 组中第一个菜单项的菜单项ID或相对位置
_In_ UINT idLast, // 组中最后一个菜单项的菜单项ID或相对位置
_In_ UINT idCheck, // 要设置选定的菜单项的菜单项ID或相对位置
_In_ UINT uFlags); // 标志,MF_BYCOMMAND或MF_BYPOSITION
如果将uFlags参数指定为MF_BYCOMMAND,则菜单项组中菜单项的ID在数值上应该是连续的;如果将uFlags参数指定为MF_BYPOSITION,则菜单项组中菜单项在菜单栏中的位置应该是连续的。主菜单中的菜单项前面不能设置单选标志。
GetMenuItemCount(hMenu)可以获取指定菜单句柄下的菜单项个数,例如对于本节开头列出的菜单资源,指定不同菜单句柄调用该函数的结果如下所示:
hMenu = GetMenu(hwnd);
n = GetMenuItemCount(hMenu); // 主菜单 3
n = GetMenuItemCount(GetSubMenu(hMenu, 0)); // 文件 6
n = GetMenuItemCount(GetSubMenu(hMenu, 1)); // 编辑 9
n = GetMenuItemCount(GetSubMenu(hMenu, 2)); // 帮助 1
某些程序在客户区内右键单击可以弹出一个菜单,叫作右键弹出菜单,也叫快捷菜单或上下文菜单,可以通过调用TrackPopupMenu或TrackPopupMenuEx函数实现:
BOOL WINAPI TrackPopupMenu(
_In_ HMENU hMenu, // 要显示的弹出菜单的句柄
_In_ UINT uFlags, // 标志
_In_ int x, // 快捷菜单的X坐标,屏幕坐标
_In_ int y, // 快捷菜单的Y坐标,屏幕坐标
_In_ int nReserved, // 保留参数
_In_ HWND hWnd, // 快捷菜单所属的窗口句柄,该窗口接收菜单命令消息
_In_opt_ const RECT *prcRect); // 忽略该参数
-
快捷菜单使用的是弹出菜单,参数hMenu指定要显示的弹出菜单的句柄,如果需要使用主菜单中的某个弹出菜单,可以使用GetSubMenu函数获取,也可以使用CreatePopupMenu函数创建一个空的弹出菜单,然后向其中添加子菜单项,还可以使用资源编辑器制作一个弹出菜单,在通过资源编辑器制作弹出菜单资源时,主菜单项的菜单名称可以随意写,因为不会显示,只会显示主菜单项下面的弹出菜单内容,然后在程序中使用LoadMenu函数加载并使用GetSubMenu函数获取第一个弹出菜单句柄。
-
参数uFlags是一些标志,常用的标志如表6.9所示。
表6.9
| 标志 | 含义 |
|---|---|
| TPM_CENTERALIGN | 快捷菜单相对于X参数指定的坐标水平居中 |
| TPM_LEFTALIGN | 快捷菜单左侧与X参数指定的坐标对齐 |
| TPM_RIGHTALIGN | 快捷菜单右侧与X参数指定的坐标对齐 |
| TPM_VCENTERALIGN | 快捷菜单相对于Y参数指定的坐标垂直居中 |
| TPM_TOPALIGN | 快捷菜单顶部与Y参数指定的坐标对齐 |
| TPM_BOTTOMALIGN | 快捷菜单底部与Y参数指定的坐标对齐 |
| TPM_LEFTBUTTON | 用户只能使用鼠标左键来选择菜单项 |
| TPM_RIGHTBUTTON | 用户使用鼠标左键或右键都可以选择菜单项 |
例如下面的代码,在客户区内单击鼠标右键的时候出现“编辑”菜单项的弹出菜单:
case WM_RBUTTONDOWN:
pt.x = GET_X_LPARAM(lParam);
pt.y = GET_Y_LPARAM(lParam);
ClientToScreen(hwnd, &pt);
TrackPopupMenu(GetSubMenu(GetMenu(hwnd), 1), TPM_LEFTALIGN | TPM_TOPALIGN,
pt.x, pt.y, 0, hwnd, NULL);
return 0;
试图显示整个主菜单是不会成功的,例如:
TrackPopupMenu(GetMenu(hwnd), TPM_LEFTALIGN | TPM_TOPALIGN, pt.x, pt.y, 0, hwnd, NULL);
显示整个主菜单,通常没有必要,不过可以采取一些变通的方法实现。使用下面的方法可以在快捷菜单中显示整个主菜单:
HMENU hMenu, hMenuPopup;
POINT pt;
TCHAR szBuf[32] = { 0 };
case WM_RBUTTONDOWN:
hMenu = GetMenu(hwnd);
// 创建一个弹出菜单
hMenuPopup = CreatePopupMenu();
// 把主菜单的每一个弹出菜单添加到刚刚创建的弹出菜单中
for (int i = 0; i < GetMenuItemCount(hMenu); i++)
{
GetMenuString(hMenu, i, szBuf, _countof(szBuf), MF_BYPOSITION);
AppendMenu(hMenuPopup, MF_STRING | MF_POPUP, (UINT_PTR)GetSubMenu(hMenu, i), szBuf);
}
pt.x = GET_X_LPARAM(lParam);
pt.y = GET_Y_LPARAM(lParam);
ClientToScreen(hwnd, &pt);
TrackPopupMenu(hMenuPopup, TPM_LEFTALIGN | TPM_TOPALIGN, pt.x, pt.y, 0, hwnd, NULL);
return 0;
效果如原书的图6.14所示。
CreatePopupMenu函数可以创建一个空的弹出菜单,然后可以使用AppendMenu、InsertMenu或InsertMenuItem函数添加菜单项:
HMENU WINAPI CreatePopupMenu(void);
刚才我们弹出快捷菜单,处理的是WM_RBUTTONDOWN消息,当默认窗口过程DefWindowProc函数处理WM_RBUTTONUP或WM_NCRBUTTONUP消息,或用户按下Shift + F10组合键时,都会生成WM_CONTEXTMENU消息,因此程序可以处理WM_CONTEXTMENU消息弹出的快捷菜单。WM_CONTEXTMENU消息的wParam参数是鼠标右键单击的窗口句柄,lParam参数的低位字是鼠标光标的X坐标,高位字是鼠标光标的Y坐标(屏幕坐标),可以使用GET_X_LPARAM和GET_Y_LPARAM宏从lParam参数中提取这两个坐标。
菜单即将变为活动状态时,包括单击菜单项、按下菜单项对应的快捷键等,窗口过程会收到WM_INITMENU消息,不过程序通常不需要处理这个消息。
在显示任何弹出菜单之前(包括快捷菜单),系统会将WM_INITMENUPOPUP消息发送到窗口过程,程序可以在用户看到之前修改菜单项,例如设置菜单项的复选、单选状态,以及在某些文本编辑器程序的剪贴板中没有内容时粘贴菜单是灰化的,等等。
每当用户单击主菜单中的菜单项或者鼠标在弹出菜单中的子菜单项之间移动时,窗口过程会收到WM_MENUSELECT消息,程序可以响应WM_MENUSELECT消息在状态栏显示提示信息,这个消息在后面讲状态栏的时候会用到。
6.1.5 扩展菜单选项与菜单项自绘
有一些扩展菜单选项无法在资源脚本文件中指定,只能通过相关函数进行设置,本节通过几个函数介绍扩展菜单选项。
InsertMenuItem函数也可以用于添加菜单项:
BOOL WINAPI InsertMenuItem(
_In_ HMENU hMenu, // 菜单句柄(可以是主菜单句柄、弹出菜单句柄等)
_In_ UINT uItem, // 用于确定菜单项插入位置,菜单项ID或相对位置
_In_ BOOL fByPosition,// 设置为TRUE表示uItem参数是相对位置,FALSE表示菜单项ID
_In_ LPCMENUITEMINFO lpmii); // 指向MENUITEMINFO结构的指针,该结构包含新菜单项的信息
MENUITEMINFO结构还可以用在SetMenuItemInfo、GetMenuItemInfo函数中,该结构在WinUser.h头文件中定义如下:
typedef struct tagMENUITEMINFOW
{
UINT cbSize; // 该结构的大小
UINT fMask; // 掩码标志,指定要获取或设置的字段
UINT fType; // 菜单项类型
UINT fState; // 菜单项状态
UINT wID; // 菜单项ID
HMENU hSubMenu; // 弹出菜单句柄
HBITMAP hbmpChecked; // 菜单项选定时的位图句柄
HBITMAP hbmpUnchecked; // 菜单项未选定时的位图句柄
ULONG_PTR dwItemData; // 与菜单项关联的程序自定义数据
LPTSTR dwTypeData; // 菜单项名称字符串
UINT cch; // 获取菜单项名称时作为缓冲区的长度,返回菜单项字符串的实际长度
HBITMAP hbmpItem; // 菜单项使用的位图句柄
} MENUITEMINFO, FAR *LPMENUITEMINFO;
- 字段fMask指定要获取或设置的字段,该字段可以是表6.10所示的一个或多个值,MIIM_前缀的意思是Menu Item Info Mask。
表6.10
| 常量 | 含义 |
|---|---|
| MIIM_FTYPE | 获取或设置fType字段 |
| MIIM_STATE | 获取或设置fState字段 |
| MIIM_ID | 获取或设置wID字段 |
| MIIM_SUBMENU | 获取或设置hSubMenu字段 |
| MIIM_CHECKMARKS | 获取或设置hbmpChecked和hbmpUnchecked字段 |
| MIIM_DATA | 获取或设置dwItemData字段 |
| MIIM_STRING | 获取或设置dwTypeData字段 |
| MIIM_BITMAP | 获取或设置hbmpItem字段 |
通常情况下都是使用字符串显示菜单项,把MENUITEMINFO.fMask字段设置为MIIM_STRING,MENUITEMINFO.dwTypeData字段指定为字符串指针(如果是获取菜单项信息,还需要把MENUITEMINFO.cch字段指定为字符串缓冲区的长度)。如果需要使用位图显示菜单项,则可以把MENUITEMINFO.fMask字段设置为MIIM_BITMAP,MENUITEMINFO. hbmpItem字段指定为位图句柄。
- 字段fType指定菜单项类型,该字段可以是表6.11所示的一个或多个值。
表6.11
| 常量 | 含义 |
|---|---|
| MFT_MENUBREAK | 菜单项在新行或新列中 |
| MFT_MENUBARBREAK | 菜单项在新行或新列中,列与列之间有分隔线 |
| MFT_SEPARATOR | 菜单项是分隔线,dwTypeData和cch字段将被忽略 |
| MFT_RADIOCHECK | 如果将hbmpChecked字段设置为NULL,菜单项前面会有一个单选标记,而不是复选标记 |
| MFT_RIGHTJUSTIFY | 该菜单项和以后的菜单项右对齐,仅适用于主菜单中的菜单项 |
| MFT_RIGHTORDER | 用于支持从右到左的语言,例如阿拉伯语和希伯来语 |
| MFT_OWNERDRAW | 菜单项由程序自绘。窗口在第一次显示菜单项之前会收到WM_MEASUREITEM消息,并且每当必须绘制菜单项时会收到WM_DRAWITEM消息(例如用户选择它时)。如果指定了这个标志,dwItemData字段可以指定为程序的自定义数据 |
- 字段fState指定菜单项状态,该字段可以是表6.12所示的一个或多个值。
表6.12
| 常量 | 含义 |
|---|---|
| MFS_CHECKED | 为菜单项设置选定标志 |
| MFS_UNCHECKED | 取消菜单项的选定标志 |
| MFS_DISABLED或MFS_GRAYED | 禁用菜单项并将其灰化,使其无法选择 |
| MFS_ENABLED | 启用菜单项以便可以选择它,这是默认状态 |
| MFS_HILITE | 突出显示菜单项 |
| MFS_UNHILITE | 取消突出显示菜单项,这是默认状态 |
| MFS_DEFAULT | 默认菜单项,菜单只能包含一个默认菜单项,以粗体显示 |
-
字段wID指定菜单项ID,或在这个字段中返回菜单项ID。
-
字段hSubMenu指定弹出菜单句柄,或在这个字段中返回弹出菜单句柄。
-
字段hbmpChecked指定选定标志使用的位图句柄。如果该字段设置为NULL,则使用默认位图。如果fType字段指定了MFT_RADIOCHECK类型,则默认位图是单选标志;否则,它是一个复选标志。
-
字段hbmpUnchecked指定菜单项未选定时的位图句柄。如果该字段设置为NULL,则不使用位图。 使用SetMenuItemBitmaps函数也可以设置菜单项选定时和未选定时菜单项前面显示的位图,可以调用GetSystemMetrics(SM_CXMENUCHECK);GetSystemMetrics(SM_CYMENUCHECK);获取所需的位图大小。
-
字段dwItemData是与菜单项关联的程序自定义数据,通常用于菜单项自绘。
-
字段dwTypeData。仅当fMask字段设置了MIIM_STRING标志时才使用dwTypeData字段。要获取MFT_STRING类型的菜单项字符串,可以先将MENUITEMINFO的dwTypeData字段设置为NULL,然后调用GetMenuItemInfo函数,cch返回菜单项所需缓冲区的大小(不包括字符串结尾标志),然后分配cch + 1大小的缓冲区,把dwTypeData字段设置为缓冲区的地址,cch设置为缓冲区的大小,再次调用GetMenuItemInfo就可以获取菜单项的名称字符串。
-
字段cch。仅当fMask字段设置了MIIM_STRING标志时才使用cch字段,如果是调用SetMenuItemInfo函数设置菜单项的内容,忽略cch字段。
-
字段hbmpItem指定菜单项所用的位图的句柄,仅当fMask字段设置了MIIM_BITMAP标志时才使用hbmpItem字段,此时菜单项显示为位图,而不是字符串。它也可以是表6.13中的值之一。
表6.13
| 常量 | 含义 |
|---|---|
| HBMMENU_CALLBACK | 程序自绘的位图,程序必须处理WM_MEASUREITEM和WM_DRAWITEM消息 |
| HBMMENU_MBAR_CLOSE | 菜单栏的关闭按钮 |
| HBMMENU_MBAR_CLOSE_D | 菜单栏的禁用关闭按钮 |
| HBMMENU_MBAR_MINIMIZE | 菜单栏的最小化按钮 |
| HBMMENU_MBAR_MINIMIZE_D | 菜单栏的禁用最小化按钮 |
| HBMMENU_MBAR_RESTORE | 菜单栏的恢复按钮 |
| HBMMENU_POPUP_CLOSE | 子菜单的关闭按钮 |
| HBMMENU_POPUP_MAXIMIZE | 子菜单的最大化按钮 |
| HBMMENU_POPUP_MINIMIZE | 子菜单的最小化按钮 |
| HBMMENU_POPUP_RESTORE | 子菜单的恢复按钮 |
| HBMMENU_SYSTEM | Windows图标或在dwItemData中指定的窗口图标 |
如果MENUITEMINFO.fType字段指定为MFT_OWNERDRAW标志,表示菜单项由程序自绘,则窗口在第一次显示菜单项之前会收到WM_MEASUREITEM消息,并且每当必须绘制菜单项时会收到WM_DRAWITEM消息(例如用户选择它时)。如果指定了这个标志,则MENUITEMINFO 结构的dwItemData字段可以指定为自定义数据,例如指向一个结构的指针。自定义数据可以包含用于绘制菜单项的信息,可以在WM_MEASUREITEM和WM_DRAWITEM消息中使用。
1.WM_MEASUREITEM消息
除了用于自绘菜单项,WM_MEASUREITEM消息也用于自绘列表框、组合框等。该消息的wParam参数就是lParam参数指向的MEASUREITEMSTRUCT结构的CtlID字段的值。如果wParam参数的值为0,则该消息是由菜单项发送的;如果wParam参数的值非零,则该消息是由列表框、组合框等发送的;如果wParam参数的值非零,并且lParam参数指向的MEASUREITEMSTRUCT结构的itemID字段的值为(UINT)−1,则该消息是由组合框的编辑控件部分发送的。通常不需要wParam参数。
lParam参数是一个指向MEASUREITEMSTRUCT结构的指针,该结构在WinUser.h头文件中定义如下:
typedef struct tagMEASUREITEMSTRUCT {
UINT CtlType; // 控件类型,如果是ODT_MENU,表示菜单项
UINT CtlID; // 该字段不用于菜单项
UINT itemID; // 菜单项ID
UINT itemWidth; // 设置菜单项的宽度,以像素为单位
UINT itemHeight; // 设置菜单项的高度,以像素为单位
ULONG_PTR itemData; // 程序自定义数据,当初由MENUITEMINFO结构的dwItemData字段指定的
} MEASUREITEMSTRUCT, NEAR *PMEASUREITEMSTRUCT, FAR *LPMEASUREITEMSTRUCT;
- CtlType字段表示控件类型,该字段可能是以下值(见表6.14)之一。
表6.14
| 常量 | 含义 |
|---|---|
| ODT_MENU | 自绘菜单项 |
| ODT_LISTBOX | 自绘列表框 |
| ODT_COMBOBOX | 自绘组合框 |
| ODT_LISTVIEW | 自绘列表视图控件 |
-
CtlID字段表示列表框、组合框等的ID,该字段不用于菜单项。
-
itemID字段表示菜单项ID,或列表框、组合框等的列表项位置索引。
-
itemWidth和itemHeight字段用于设置菜单项,或列表框、组合框等的列表项宽度和高度。对WM_MEASUREITEM消息的处理主要就是通过设置itemWidth和itemHeight字段的值来指定菜单项或自绘控件列表项的宽度和高度。
-
itemData字段是菜单项的自定义数据,或列表框、组合框等的列表项项目数据。
窗口过程处理完WM_MEASUREITEM消息以后应返回TRUE。
2.WM_DRAWITEM消息
对WM_MEASUREITEM消息的处理主要就是通过设置itemWidth和itemHeight字段的值来指定菜单项或自绘控件列表项的宽度和高度。当菜单项或列表框、组合框、按钮等的外观需要改变时,会向父窗口发送WM_DRAWITEM消息。如果WM_DRAWITEM消息是由列表框、组合框、按钮等控件发送的,则wParam参数是控件的ID;如果是由菜单发送的,则wParam参数是0。lParam参数是一个指向DRAWITEMSTRUCT结构的指针,该结构在WinUser.h头文件中定义如下:
typedef struct tagDRAWITEMSTRUCT {
UINT CtlType; // 控件类型,如果是ODT_MENU,表示菜单项
UINT CtlID; // 该字段不用于菜单项
UINT itemID; // 菜单项ID
UINT itemAction; // 所需的绘制操作
UINT itemState; // 新的状态
HWND hwndItem; // 菜单句柄
HDC hDC; // 设备环境句柄
RECT rcItem; // 绘制区域
ULONG_PTR itemData; // 程序自定义数据,最初由MENUITEMINFO结构的dwItemData指定的
} DRAWITEMSTRUCT, NEAR *PDRAWITEMSTRUCT, FAR *LPDRAWITEMSTRUCT;
- CtlType字段表示控件类型,可以是表6.15所示的值之一。
表6.15
| 常量 | 含义 |
|---|---|
| ODT_MENU | 菜单项 |
| ODT_BUTTON | 按钮 |
| ODT_LISTBOX | 列表框 |
| ODT_LISTVIEW | 列表视图控件 |
| ODT_COMBOBOX | 组合框 |
| ODT_STATIC | 静态控件 |
| ODT_TAB | Tab控件 |
-
CtlID字段表示列表框、组合框、按钮等的控件ID,不用于菜单项。
-
itemID字段表示菜单项ID,或列表框、组合框、按钮等的列表项位置索引。
-
itemAction字段表示所需的绘制操作,可以是表6.16所示的值的组合。
表6.16
| 常量 | 含义 |
|---|---|
| ODA_DRAWENTIRE | 需要绘制整个控件 |
| ODA_FOCUS | 控件已经获得或失去键盘焦点,应该检查itemState字段的值以确定控件是否具有焦点 |
| ODA_SELECT | 选择状态已更改,应该检查itemState字段的值以确定新的选择状态 |
- itemState字段表示新的状态,可以是表6.17所示的值的组合。
表6.17
| 常量 | 含义 |
|---|---|
| ODS_SELECTED | 已选择菜单项 |
| ODS_CHECKED | 已选中菜单项 |
| ODS_GRAYED | 灰化菜单项 |
| ODS_DISABLED | 禁用 |
| ODS_HOTLIGHT | 突出显示 |
| ODS_FOCUS | 该项目具有键盘焦点 |
| ODS_INACTIVE | 该项目处于非活动状态 |
| ODS_DEFAULT | 该项目是默认项目 |
| ODS_COMBOBOXEDIT | 组合框的编辑控件 |
| ODS_NOACCEL | 没有按下加速键的情况下进行绘制 |
| ODS_NOFOCUSRECT | 没有键盘焦点的情况下进行绘制 |
-
hwndItem字段表示菜单句柄,或列表框、组合框、按钮等的窗口句柄。
-
hDC字段表示设备环境句柄。进行自绘操作需要使用设备环境句柄。
-
rcItem字段表示要绘制的菜单项或列表框、组合框、按钮等的矩形边界。
-
itemData字段表示与菜单项关联的应用程序定义的自定义数据,或列表框、组合框等的项目数据。
对WM_DRAWITEM消息的处理,主要是根据itemState字段表示的状态绘制出不同的效果。窗口过程处理完WM_DRAWITEM消息以后应返回TRUE。
无法通过可视化的资源编辑器来定义菜单项自绘选项,可以使用MF_OWNERDRAW标志调用AppendMenu、InsertMenu、ModifyMenu函数,也可以使用MFT_OWNERDRAW(等于MF_OWNERDRAW)标志调用InsertMenuItem、SetMenuItemInfo函数来指定菜单项由程序自绘。
还可以通过修改资源脚本文件的方式来定义菜单项自绘选项,Chapter6\HelloWindows3\ HelloWindows\HelloWindows.rc文件的菜单资源部分如下所示:
IDR_MENU MENUEX
BEGIN
POPUP "文件", 65535,MFT_STRING,MFS_ENABLED
BEGIN
MENUITEM "新建(&N)\tCtrl+N", ID_FILE_NEW,MFT_STRING, MFS_ENABLED
MENUITEM "打开(&O)\tCtrl+O", ID_FILE_OPEN,MFT_STRING, MFS_ENABLED
MENUITEM "保存(&S)\tCtrl+S", ID_FILE_SAVE,MFT_STRING, MFS_ENABLED
MENUITEM "另存为(&A)", ID_FILE_SAVEAS,MFT_STRING, MFS_ENABLED
MENUITEM MFT_SEPARATOR
MENUITEM "退出(&X)", ID_FILE_EXIT,MFT_STRING, MFS_ENABLED
END
POPUP "编辑", 65535,MFT_STRING,MFS_ENABLED
BEGIN
MENUITEM "剪切(&T)\tCtrl+X", ID_EDIT_CUT,MFT_STRING, MFS_ENABLED
MENUITEM "复制(&C)\tCtrl+C", ID_EDIT_COPY,MFT_STRING, MFS_ENABLED
MENUITEM "粘贴(&P)\tCtrl+V", ID_EDIT_PASTE,MFT_STRING, MFS_ENABLED
MENUITEM MFT_SEPARATOR
MENUITEM "红色(&R)", ID_EDIT_RED,MFT_STRING, MFS_ENABLED
MENUITEM "绿色(&G)", ID_EDIT_GREEN,MFT_STRING, MFS_ENABLED
MENUITEM "蓝色(&B)", ID_EDIT_BLUE,MFT_STRING, MFS_ENABLED
MENUITEM MFT_SEPARATOR
POPUP "更改大小写(&N)", 65535,MFT_STRING,MFS_ENABLED
BEGIN
MENUITEM "大写字母(&U)", ID_EDIT_UPPER,MFT_STRING, MFS_ENABLED
MENUITEM "小写字母(&L)", ID_EDIT_LOWER,MFT_STRING, MFS_ENABLED
END
END
POPUP "帮助", 65535,MFT_STRING | MFT_RIGHTJUSTIFY,MFS_ENABLED
BEGIN
MENUITEM "关于HelloWindows(&A)", ID_HELP_ABOUT,MFT_STRING, MFS_ENABLED
END
END
把除主菜单中“文件”“编辑”和“帮助”以外的所有子菜单项的MFT_STRING属性改为MFT_STRING | MFT_OWNERDRAW即可。程序通过处理WM_MEASUREITEM和WM_DRAWITEM消息进行自绘。程序运行效果如原书的图6.15所示。
具体代码参见Chapter6\HelloWindows3项目。
6.2 图标
图标在系统中随处可见,系统使用图标来表示文件、文件夹、快捷方式、应用程序和文档等对象。除了可以使用系统预定义的IDI_前缀的那些标准图标,程序也可以自定义图标。小图标通常用于窗口标题栏左侧和任务栏,可以使用SM_CXSMICON和SM_CYSMICON参数调用GetSystemMetrics函数获取小图标的尺寸,通常是16 16;大图标通常用于可执行文件和快捷方式,可以使用SM_CXICON和SM_CYICON参数调用GetSystemMetrics函数获取大图标的尺寸,通常是32 32。图标文件的后缀名是.ico,每个图标通常含有多张内容相同的图片,每一张图片具有不同的尺寸和颜色数,标准尺寸有16 16、32 32、48 48、64 64、96 96、128 128、256 256、512 512等,Windows会根据需要显示不同尺寸的图标。
图标文件(.ico文件)使用类似.bmp文件格式的结构来保存,但图标的文件头中包含了一些信息以指定文件中含有多少个图标文件以及相关的信息。另外,在每个图标的数据区中还包含透明区(也叫掩码)的设置信息。光标文件(.cur文件)也使用这种格式,因此,在大部分时候图标与光标可以互相替代使用。
为程序添加图标资源很简单,打开资源视图,用鼠标右键单击项目名称,然后选择添加 → 资源,打开添加资源对话框,选择Icon类型,单击“导入”按钮,可以选择一个已经制作好的图标。单击“新建”的话就是自己绘制图标,大家可以试一下,资源编辑器通常要求绘制几张不同尺寸的图标。我选择的是Chapter6\HelloWindows4\HelloWindows\Eagle.ico(一只老鹰的图标文件),最大尺寸为256 256。
看一下资源脚本文件HelloWindows.rc中图标资源的定义:
IDI_EAGLE ICON "Eagle.ico"
图标ID同样可以是一个字符串或1~65535之间的数字。
资源头文件resource.h中也自动添加了IDI_EAGLE的常量定义:
#define IDI_EAGLE 103
为程序设置图标很简单,LoadIcon或LoadImage函数可以从应用程序实例中加载指定的图标资源:
wndclass.hIcon = LoadIcon(hInstance, MAKEINTRESOURCE(IDI_EAGLE));
wndclass.hIconSm字段指定小图标,用于窗口标题栏左侧和任务栏。这个字段通常没有必要指定,因为系统会搜索可执行文件的图标资源以查找合适大小的图标作为小图标。
编译运行程序,可以看到窗口标题栏左侧和任务栏的图标都变成了我们设置的图标。打开资源管理器,可以看到程序文件的图标也变了。更改资源管理器的文件视图为大图标、超大图标以后,程序文件的图标也随之增大而且图标不失真,这是因为我们提供的图标资源文件尺寸比较大。请注意,系统对图标有缓存,资源管理器中有时候可能不能立即更新程序图标。
关于编译生成的可执行文件使用的图标,如果我们添加了多个图标资源,则系统会选择资源头文件resource.h中最先定义的那个图标作为可执行文件的图标。例如,我又添加了一个笑脸图标,HelloWindows.rc文件的部分内容如下:
IDI_EAGLE ICON "Eagle.ico"
IDI_SMILE ICON "Smile.ico"
resource.h文件的部分内容如下:
#define IDI_SMILE 103
#define IDI_EAGLE 104
HelloWindows.cpp源文件的部分内容如下:
wndclass.hIcon = LoadIcon(NULL, IDI_APPLICATION);
编译运行程序,可以发现生成的可执行文件的图标为笑脸,任务栏的图标也是笑脸,而窗口标题栏左侧的图标为系统预定义的IDI_APPLICATION图标。因此,如果定义了多个图标,在resource.h头文件中应该首先定义要设置为程序图标的图标文件。当然,wndclass.hIcon字段应该设置为要作为程序图标的图标文件对应的图标句柄,要保持一致。
如果需要动态更换图标,可以指定GCLP_HICON参数调用SetClassLong或SetClassLongPtr函数,例如下面的代码:
SetClassLongPtr(hwnd, GCLP_HICON, (LONG)LoadIcon(g_hInstance, MAKEINTRESOURCE(IDI_EAGLE)));
可以发现,窗口标题栏左侧和任务栏的图标都变成了老鹰,但不会影响可执行文件的图标。
要动态更换图标,也可以发送WM_SETICON消息,例如:
SendMessage(hwnd, WM_SETICON, ICON_BIG, (LPARAM)LoadIcon(g_hInstance, MAKEINTRESOURCE (IDI_EAGLE)));
效果和调用SetClassLong或SetClassLongPtr函数是一样的。WM_SETICON消息的wParam参数指定要设置的图标类型,指定为ICON_BIG表示设置窗口的大图标,指定为ICON_SMALL表示设置窗口的小图标。在Alt + Tab对话框中显示大图标,在窗口标题栏左侧和任务栏中显示小图标。但是不管指定为ICON_BIG还是ICON_SMALL,Alt + Tab对话框中以及窗口标题栏左侧和任务栏的图标都是同时改变;lParam参数被指定为新大图标或小图标的句柄。
6.3 光标
除了可以使用系统预定义的那些IDC_前缀开头的标准光标,程序也可以自定义光标。光标文件的后缀名是.cur,系统也支持动态光标,动态光标文件的后缀名是.ani。光标和图标文件是类似的,通常它们可以互换使用。
要添加光标资源只需选择Cursor类型,我导入的是Chapter6\HelloWindows4\HelloWindows\ MacCursor\point.cur光标文件,看一下资源脚本文件HelloWindows.rc中光标资源的定义:
IDC_POINT CURSOR "MacCursor\\point.cur"
光标ID同样可以是一个字符串或1~65535之间的数字。
资源头文件resource.h中也自动添加了IDC_POINT的常量定义:
#define IDC_POINT 106
为程序设置光标,LoadCursor或LoadImage函数可以从应用程序实例中加载指定的光标资源:
wndclass.hCursor = LoadCursor(hInstance, MAKEINTRESOURCE(IDC_POINT));
编译运行程序,可以看到当鼠标在客户区中的时候,鼠标光标变成了黑色箭头形状。
资源编辑器中没有内置动态光标类型,只能将其作为自定义资源去添加。要加载动态光标,也可以使用LoadCursorFromFile函数从文件中加载,例如:
wndclass.hCursor = LoadCursorFromFile(TEXT("MacCursor\\point.cur")); // 普通光标
wndclass.hCursor = LoadCursorFromFile(TEXT("LittleNinja\\ninjanormal.ani")); // 动态光标
SetSystemCursor函数可以使用指定的光标替换掉系统光标:
BOOL WINAPI SetSystemCursor(
_In_ HCURSOR hcur, // 用这个光标替换掉系统光标
_In_ DWORD id); // 系统光标ID
参数id指定哪个系统光标将被替换,可以是表6.18所示的值之一。这些值和讲解注册窗口类时的那些IDC_开头的系统预定义光标一一对应。
表6.18
| 常量 | 含义 | 与IDC_开头的常量的关系 |
|---|---|---|
| OCR_APPSTARTING | 标准箭头和等待(忙碌) | #define IDC_APPSTARTING MAKEINTRESOURCE(OCR_APPSTARTING) |
| OCR_NORMAL | 标准箭头 | #define IDC_ARROW MAKEINTRESOURCE(OCR_NORMAL) |
| OCR_CROSS | 十字线 | #define IDC_CROSS MAKEINTRESOURCE(OCR_CROSS) |
| OCR_HAND | 手形 | #define IDC_HAND MAKEINTRESOURCE(OCR_HAND) |
| OCR_HELP | 箭头和问号 | #define IDC_HELP MAKEINTRESOURCE(32651) |
| OCR_IBEAM | 工字 | #define IDC_IBEAM MAKEINTRESOURCE(OCR_IBEAM) |
| OCR_NO | 斜线圆 | #define IDC_NO MAKEINTRESOURCE(OCR_NO) |
| OCR_SIZEALL | 北、南、东和西的四角箭头 | #define IDC_SIZEALL MAKEINTRESOURCE(OCR_SIZEALL) |
| OCR_SIZENESW | 指向东北和西南的双向箭头 | #define IDC_SIZENESW MAKEINTRESOURCE(OCR_SIZENESW) |
| OCR_SIZENS | 指向南北的双向箭头 | #define IDC_SIZENS MAKEINTRESOURCE(OCR_SIZENS) |
| OCR_SIZENWSE | 指向西北和东南的双向箭头 | #define IDC_SIZENWSE MAKEINTRESOURCE(OCR_SIZENWSE) |
| OCR_SIZEWE | 指向西和东的双向箭头 | #define IDC_SIZEWE MAKEINTRESOURCE(OCR_SIZEWE) |
| OCR_UP | 垂直箭头 | #define IDC_UPARROW MAKEINTRESOURCE(OCR_UP) |
| OCR_WAIT | 等待(忙碌) | #define IDC_WAIT MAKEINTRESOURCE(OCR_WAIT) |
可以看到,参数id指定的是系统光标的资源ID,而IDC_开头的这些常量则是被MAKEINTRESOURCE宏转换为了字符串类型。如果需要使用OCR_开头的常量,在包含Windows.h头文件之前必须定义常量OEMRESOURCE,例如:#define OEMRESOURCE 1。
调用SetSystemCursor函数以后,系统会调用DestroyCursor函数销毁参数hcur指定的光标资源。因此单纯通过调用LoadCursor函数加载光标,并将得到的光标句柄用于SetSystemCursor函数无法达到目的,还需要调用CopyCursor(hcur)宏复制光标得到光标副本,然后把光标副本传递给SetSystemCursor函数:
SetSystemCursor(CopyCursor(LoadCursor(g_hInstance, MAKEINTRESOURCE(IDC_POINT))), OCR_NORMAL);
SetSystemCursor(CopyCursor(LoadCursorFromFile(TEXT("LittleNinja\\ninjanormal.ani"))), OCR_NORMAL);
不过,这不是永久的,重启计算机后,被替换的光标会被恢复。
CopyCursor宏是调用的CopyIcon函数。另外,还有一个CopyImage函数,可以用于复制图标、光标和位图:
#define CopyCursor(pcur) ((HCURSOR)CopyIcon((HICON)(pcur)))
HANDLE CopyImage(
_In_ HANDLE h, // 要复制的图像的句柄
_In_ UINT type, // 要复制的图像类型:IMAGE_ICON、IMAGE_CURSOR或IMAGE_BITMAP
_In_ int cx, // 新图像的宽度(像素),如果设置为0,则复制的图像与原始图像的宽度相同
_In_ int cy, // 新图像的高度(像素),如果设置为0,则复制的图像与原始图像的高度相同
_In_ UINT flags); // 复制标志
如果需要动态更换光标,可以指定GCLP_HCURSOR参数调用SetClassLong或SetClassLongPtr函数,例如下面的代码:
SetClassLongPtr(hwnd, GCLP_HCURSOR, (LONG)LoadCursor(g_hInstance, MAKEINTRESOURCE(IDC_
POINT)));
SetClassLongPtr(hwnd, GCLP_HCURSOR, (LONG)LoadCursorFromFile(TEXT("LittleNinja
\\ninjanormal.ani")));
请注意:发送WM_SETCURSOR消息不能更换光标,这个消息是刷新光标。SetCursor函数虽然可以用来设置光标,但这只能将新的光标维持很短的一段时间,因为当Windows向窗口过程重新发送WM_SETCURSOR消息的时候,DefWindowProc执行默认处理光标就会被设置为原来的形状,Windows会经常向窗口过程发送WM_SETCURSOR消息。
如果需要在客户区中绘制图标或光标,可以使用DrawIcon或DrawIconEx函数:
BOOL WINAPI DrawIcon(
_In_ HDC hDC, // 设备环境句柄
_In_ int X, // 图标或光标左上角的X坐标
_In_ int Y, // 图标或光标左上角的Y坐标
_In_ HICON hIcon); // 要绘制的图标句柄或光标句柄
DrawIcon函数使用GetSystemMetrics(SM_CXICON)和GetSystemMetrics(SM_CYICON)获取的宽度和高度值绘制图标或光标,通常是32 32。
6.4 字符串表
程序中用到的字符串,也可以在资源脚本文件中定义,不过使用起来可能比直接在程序源文件中定义稍微复杂一点,但是一个程序如果需要更改为另一种语言版本,那么直接修改一下资源脚本文件中的字符串资源,然后重新编译即可。如果字符串定义在程序源文件中,修改起来就不那么直观了。
有的程序可以让用户选择语言版本,可以在字符串表中定义不同语言的字符串,同一语言的字符串按规律排列,例如中文版本的字符串ID以10000开头,英文版本的以20000开头。程序可以根据用户选择的语言加载不同语言的字符串。
通过资源编辑器添加字符串表,只需要选择String Table类型,然后单击“新建”按钮,并向其中添加字符串即可。接下来,我想把HelloWindows程序的菜单设置为简体中文和英语两个版本,因此需要为每个菜单项分别制作两种语言的字符串。资源脚本文件HelloWindows.rc的字符串表部分如下所示:
STRINGTABLE
BEGIN
IDS_FILE "文件"
IDS_EDIT "编辑"
IDS_LANGUAGE "语言"
IDS_HELP "帮助"
IDS_FILE_NEW "新建(&N)\tCtrl+N"
IDS_FILE_OPEN "打开(&O)\tCtrl+O"
IDS_FILE_SAVE "保存(&S)\tCtrl+S"
IDS_FILE_SAVEAS "另存为(&A)"
IDS_FILE_EXIT "退出(&X)"
IDS_EDIT_CUT "剪切(&T)\tCtrl+X"
IDS_EDIT_COPY "复制(&C)\tCtrl+C"
IDS_EDIT_PASTE "粘贴(&P)\tCtrl+V"
IDS_HELP_ABOUT "关于HelloWindows(&A)\tCtrl+Shift+A"
IDS_EDIT_RED "红色(&R)"
IDS_EDIT_GREEN "绿色(&G)"
IDS_EDIT_BLUE "蓝色(&B)"
IDS_LANGUAGE_CHINESE "简体中文(&C)"
IDS_LANGUAGE_ENGLISH "英语(&E)"
IDS_FILE_E "File"
IDS_EDIT_E "Edit"
IDS_LANGUAGE_E "Language"
IDS_HELP_E "Help"
IDS_FILE_NEW_E "New(&N)\tCtrl+N"
IDS_FILE_OPEN_E "Open(&O)\tCtrl+O"
IDS_FILE_SAVE_E "Save(&S)\tCtrl+S"
IDS_FILE_SAVEAS_E "Save As(&A)"
IDS_FILE_EXIT_E "Exit(&X)"
IDS_EDIT_CUT_E "Cut(&T)\tCtrl+X"
IDS_EDIT_COPY_E "Copy(&C)\tCtrl+C"
IDS_EDIT_PASTE_E "Paste(&P)\tCtrl+V"
IDS_HELP_ABOUT_E "About HelloWindows(&A)\tCtrl+Shift+A"
IDS_EDIT_RED_E "Red(&R)"
IDS_EDIT_GREEN_E "Green(&G)"
IDS_EDIT_BLUE_E "Blue(&B)"
IDS_LANGUAGE_CHINESE_E "Chinese(&C)"
IDS_LANGUAGE_ENGLISH_E "English(&E)"
END
字符串表资源不需要ID,一个字符串表中可以定义多个字符串,一行表示一个字符串的定义,字符串的定义由字符串ID和字符串组成。一个字符串最多可以有4097个字符,字符串中可以包含\t、\n、%s一类的转义字符和格式化字符。对于32位字符串资源,整个字符串表的最大长度为65535个字符。
看一下资源头文件resource.h中对于字符串ID的定义:
#define IDS_FILE 10000
#define IDS_EDIT 10001
#define IDS_LANGUAGE 10002
#define IDS_HELP 10003
#define IDS_FILE_NEW 10010
#define IDS_FILE_OPEN 10011
#define IDS_FILE_SAVE 10012
#define IDS_FILE_SAVEAS 10013
#define IDS_FILE_EXIT 10014
#define IDS_EDIT_CUT 10015
#define IDS_EDIT_COPY 10016
#define IDS_EDIT_PASTE 10017
#define IDS_HELP_ABOUT 10018
#define IDS_EDIT_RED 10019
#define IDS_EDIT_GREEN 10020
#define IDS_EDIT_BLUE 10021
#define IDS_LANGUAGE_CHINESE 10022
#define IDS_LANGUAGE_ENGLISH 10023
#define IDS_FILE_E 20000
#define IDS_EDIT_E 20001
#define IDS_LANGUAGE_E 20002
#define IDS_HELP_E 20003
#define IDS_FILE_NEW_E 20010
#define IDS_FILE_OPEN_E 20011
#define IDS_FILE_SAVE_E 20012
#define IDS_FILE_SAVEAS_E 20013
#define IDS_FILE_EXIT_E 20014
#define IDS_EDIT_CUT_E 20015
#define IDS_EDIT_COPY_E 20016
#define IDS_EDIT_PASTE_E 20017
#define IDS_HELP_ABOUT_E 20018
#define IDS_EDIT_RED_E 20019
#define IDS_EDIT_GREEN_E 20020
#define IDS_EDIT_BLUE_E 20021
#define IDS_LANGUAGE_CHINESE_E 20022
#define IDS_LANGUAGE_ENGLISH_E 20023
对于简体中文,主菜单中的菜单项字符串ID从10000开始,子菜单项字符串ID从10010开始;对于英语,主菜单中的菜单项字符串ID从20000开始,子菜单项字符串ID从20010开始。
Chapter6\HelloWindows5\HelloWindows\HelloWindows.cpp源文件的内容如下:
#include <Windows.h>
#include <tchar.h>
#include "resource.h"
// 全局变量
HINSTANCE g_hInstance;
UINT g_uLanguage;
// 函数声明,窗口过程
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam);
VOID ShowMenu(HWND hwnd, UINT uLanguage);
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int
nCmdShow)
{
WNDCLASSEX wndclass;
TCHAR szClassName[] = TEXT("MyWindow");
TCHAR szAppName[] = TEXT("HelloWindows");
HWND hwnd;
MSG msg;
g_hInstance = hInstance;
wndclass.cbSize = sizeof(WNDCLASSEX);
wndclass.style = CS_HREDRAW | CS_VREDRAW;
wndclass.lpfnWndProc = WindowProc;
wndclass.cbClsExtra = 0;
wndclass.cbWndExtra = 0;
wndclass.hInstance = hInstance;
wndclass.hIcon = LoadIcon(hInstance, MAKEINTRESOURCE(IDI_FEATHER));
wndclass.hCursor = LoadCursor(NULL, IDC_ARROW);
wndclass.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH);
wndclass.lpszMenuName = NULL;
wndclass.lpszClassName = szClassName;
wndclass.hIconSm = NULL;
RegisterClassEx(&wndclass);
HMENU hMenu = LoadMenu(hInstance, MAKEINTRESOURCE(IDR_MENU));
hwnd = CreateWindowEx(0, szClassName, szAppName, WS_OVERLAPPEDWINDOW,
CW_USEDEFAULT, CW_USEDEFAULT, 400, 300, NULL, hMenu, hInstance, NULL);
ShowWindow(hwnd, nCmdShow);
UpdateWindow(hwnd);
HACCEL hAccel = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDR_ACC));
while (GetMessage(&msg, NULL, 0, 0) != 0)
{
if (!TranslateAccelerator(hwnd, hAccel, &msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
return msg.wParam;
}
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
switch (uMsg)
{
case WM_CREATE:
g_uLanguage = 10000;
return 0;
case WM_COMMAND:
// 此处没有实现多语言
switch (LOWORD(wParam))
{
case ID_FILE_NEW:
MessageBox(hwnd, TEXT("按下了 新建"), TEXT("提示"), MB_OK);
break;
case ID_EDIT_CUT:
MessageBox(hwnd, TEXT("按下了 剪切"), TEXT("提示"), MB_OK);
break;
case ID_HELP_ABOUT:
MessageBox(hwnd, TEXT("按下了 关于HelloWindows"), TEXT("提示"), MB_OK);
break;
case ID_FILE_EXIT:
SendMessage(hwnd, WM_CLOSE, 0, 0);
break;
case ID_LANGUAGE_CHINESE:
g_uLanguage = 10000;
ShowMenu(hwnd, g_uLanguage);
break;
case ID_LANGUAGE_ENGLISH:
g_uLanguage = 20000;
ShowMenu(hwnd, g_uLanguage);
break;
}
return 0;
case WM_INITMENUPOPUP:
if (g_uLanguage == 10000)
CheckMenuRadioItem(GetSubMenu(GetMenu(hwnd), 2), ID_LANGUAGE_CHINESE,
ID_LANGUAGE_ENGLISH, ID_LANGUAGE_CHINESE, MF_BYCOMMAND);
else
CheckMenuRadioItem(GetSubMenu(GetMenu(hwnd), 2), ID_LANGUAGE_CHINESE,
ID_LANGUAGE_ENGLISH, ID_LANGUAGE_ENGLISH, MF_BYCOMMAND);
return 0;
case WM_DESTROY:
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
VOID ShowMenu(HWND hwnd, UINT uLanguage)
{
HMENU hMenu, hMenuPopup, hMenuTemp, hMenuPopupTemp;
TCHAR szBuf[256] = { 0 };
UINT uID;
hMenu = LoadMenu(g_hInstance, MAKEINTRESOURCE(IDR_MENU)); // 菜单资源的主菜单
hMenuTemp = CreateMenu(); // 主菜单
for (int i = 0; i < GetMenuItemCount(hMenu); i++)
{
hMenuPopup = GetSubMenu(hMenu, i); // 菜单资源的每个弹出菜单
hMenuPopupTemp = CreateMenu(); // 每个弹出菜单
for (int j = 0; j < GetMenuItemCount(hMenuPopup); j++)
{
uID = GetMenuItemID(hMenuPopup, j);
GetMenuString(hMenuPopup, j, szBuf, _countof(szBuf), MF_BYPOSITION);
// 判断是不是分隔线
if (_tcslen(szBuf) != 0)
{
// 子菜单项的ID从40010开始,子菜单项字符串的ID就是:uID – 40000 + uLanguage
LoadString(g_hInstance, uID - 40000 + uLanguage, szBuf, _countof(szBuf));
AppendMenu(hMenuPopupTemp, MF_STRING, uID, szBuf);
}
else
{
AppendMenu(hMenuPopupTemp, MF_SEPARATOR, 0, NULL);
}
}
// 将每个弹出菜单添加到主菜单
LoadString(g_hInstance, uLanguage + i, szBuf, _countof(szBuf));
AppendMenu(hMenuTemp, MF_STRING | MF_POPUP, (UINT_PTR)hMenuPopupTemp, szBuf);
}
SetMenu(hwnd, hMenuTemp);
DrawMenuBar(hwnd);
}
具体代码参见Chapter6\HelloWindows5项目。在WM_INITMENUPOPUP消息中,根据用户当前所选择的语言,在“简体中文”或“英语”菜单项前面显示一个单选标志。
就上面的示例而言,定义“简体中文”和“英语”两个菜单资源会更简单一些,在此只是演示另一种实现方法。
6.5 程序版本信息
什么是版本信息呢?在我的电脑上,devenv.exe是VS的主程序文件,用鼠标右键单击该文件,选择属性,打开devenv.exe属性对话框。在详细信息选项卡可以看到以下信息,如原书的图6.16所示。
要添加版本信息资源,只需要选择Version类型的资源,单击“新建”按钮,然后根据需要进行修改即可,直接编译程序,生成的程序文件就会有版本信息。
打开HelloWindows.rc看一下资源脚本文件中版本信息的定义,然后进行具体解释:
VS_VERSION_INFO VERSIONINFO
FILEVERSION 1,0,0,1
PRODUCTVERSION 1,0,0,1
FILEFLAGSMASK 0x3fL
#ifdef _DEBUG
FILEFLAGS 0x3L
#else
FILEFLAGS 0x2L
#endif
FILEOS 0x40004L
FILETYPE 0x1L
FILESUBTYPE 0x0L
BEGIN
BLOCK "StringFileInfo"
BEGIN
BLOCK "080404B0"
BEGIN
VALUE "CompanyName", "Windows程序设计研究中心"
VALUE "FileDescription", "程序版本信息示例程序"
VALUE "FileVersion", "1.1"
VALUE "InternalName", "HelloWin.exe"
VALUE "LegalCopyright", "Copyright (C) 2019"
VALUE "OriginalFilename", "HelloWin.exe"
VALUE "ProductName", "HelloWindows"
VALUE "ProductVersion", "1.1"
END
END
BLOCK "VarFileInfo"
BEGIN
VALUE "Translation", 0x804, 1200
END
END
前面的FILEVERSION、PRODUCTVERSION、FILEFLAGSMASK、FILEFLAGS、FILEOS、FILETYPE、FILESUBTYPE属于版本信息的固定属性,具体含义如表6.19所示。
表6.19
| 属性 | 含义 |
|---|---|
| FILEVERSION | 文件版本号 |
| PRODUCTVERSION | 产品版本号 |
| FILEFLAGSMASK | 指定FILEFLAGS属性中哪些位有效 |
| FILEFLAGS | 文件版本标志,VS_FF_DEBUG(0x00000001)调试版本、VS_FF_PRERELEASE (0x00000002)预发行版本、VS_FF_PATCHED(0x00000004)补丁版本、VS_FF_PRIVATEBUILD(0x00000008)内部版本、VS_FF_SPECIALBUILD(0x00000020)特殊版本等 |
| FILEOS | 适用的操作系统,可以是VOS_UNKNOWN(0x00000000)、VOS_NT(0x00040000)、VOS_WINCE (0x00050000)、VOS_NT_WINDOWS32(0x00040004)等 |
| FILETYPE | 文件类型,可以是VFT_UNKNOWN(0x00000000)、VFT_APP(0x00000001)、VFT_DLL (0x00000002)、VFT_DRV(0x00000003)、VFT_FONT(0x00000004)、VFT_VXD(0x00000005)、VFT_STATIC_LIB(0x00000007)等 |
| FILESUBTYPE | 文件的子类型 |
后面是一些块声明,块声明有两种:变量类型的信息块和字符串类型的信息块。
变量类型的信息块定义方式如下:
BLOCK "VarFileInfo"
BEGIN
VALUE "Translation", 语言ID, 字符集ID
……
END
语言ID的常用值有0x0804(简体中文)、0x0404(繁体中文)、0x0409(美式英语),字符集ID的常用值有1200(Unicode)、0(7位ASCII),一般使用0x804和0x04B0来定义,也就是简体中文和Unicode(0x04B0的十进制是1200)。变量类型信息块用来表示资源中定义了哪些语言和字符集的字符串类型信息块,例如本例中有一句“VALUE “Translation”, 0x804, 1200”表示对应有一个名为“080404B0”的字符串类型的信息块。语言和字符集是在变量类型信息块中定义的,其值是将语言ID和字符集ID组合成一个十六进制格式。
字符串类型信息块的定义格式如下:
BLOCK "StringFileInfo"
BEGIN
BLOCK "语言集"
BEGIN
VALUE "字符串名称", "字符串"
……
END
END
在语言和字符集的字符串类型信息块的定义中,可以定义多条字符串类型的版本信息。这些版本信息的字符串名称有12种,如表6.20所示。
表6.20
| 字符串名称 | 含义 |
|---|---|
| Comments | 备注 |
| CompanyName | 公司 |
| FileDescription | 文件说明 |
| FileVersion | 产品版本 |
| InternalName | 内部名称 |
| LegalCopyright | 版权 |
| LegalTrademarks | 合法商标 |
| OriginalFilename | 原始文件名 |
| PrivateBuild | 内部版本说明 |
| ProductName | 产品名称 |
| ProductVersion | 产品版本 |
| SpecialBuild | 特殊版本说明 |
如果想要获取一个可执行文件的版本信息,需要使用GetFileVersionInfoSize、GetFileVersionInfo、VerQueryValue共3个函数。首先调用GetFileVersionInfoSize函数检测可执行文件中有没有版本信息资源,函数返回版本信息资源的字节长度;如果检测到文件中有版本信息资源,调用GetFileVersionInfo函数将版本信息读取到一个缓冲区中;然后调用VerQueryValue从缓冲区中分别获取每一项的信息。版本信息不是本书的重点,在此不再举例。
6.6 自定义资源
通过自定义资源,可以在可执行文件中添加任何格式的数据,可以是二进制数据,也可以是一个磁盘文件。自定义资源的用途非常广泛,例如稍微复杂一点的程序除了有一个主程序,还有动态链接库文件。可以把.dll文件打包到可执行文件中,用户运行程序的时候把它们释放到本地;可以把病毒木马程序嵌入可执行文件中,用户运行程序的时候,释放出来并执行;程序运行过程中,可能需要一些数据,可以作为自定义资源嵌入可执行文件中,需要的时候随时加载,等等。
要添加自定义资源,打开资源视图,用鼠标右键单击项目名称,然后选择添加→资源,打开添加资源对话框,单击“自定义”按钮,弹出新建自定义资源对话框,要求我们输入资源类型,资源类型可以随意写,例如输入MyData,单击“确定”按钮,可以看到资源编辑器自动添加了MyData类型的资源IDR_MYDATA1,修改资源ID为IDR_MYDATA,就可以在资源编辑器中输入我们需要的二进制数据了。如原书的图6.17所示。
这些二进制数据需要保存为文件,然后编译程序,就可以嵌入可执行文件中。可以修改一下文件名,如原书的图6.18所示。
然后,按Ctrl + S组合键保存。回到资源管理器解决方案视图,在资源文件下面有一个mydata1.bin文件,这个是刚才VS自动生成的,将其删除,我们只需要MyData.bin。
打开资源脚本文件HelloWindows.rc,看一下刚刚添加的自定义资源的定义语句:
IDR_MYDATA MYDATA "MyData.bin"
如果想使用其他文件作为自定义资源,可以把MyData.bin换为其他文件名。
资源头文件resource.h中也添加了对IDR_MYDATA的ID常量定义:
#define IDR_MYDATA 107
如果需要把一个文件作为自定义资源,则可以打开添加资源对话框,单击“导入”,选择所需的文件,然后单击“打开”按钮。如果不是常见的Windows文件类型,VS会要求我们输入资源类型名称。在这里我选择的是“站着等你三千年.wav”,单击打开以后,如原书的图6.19所示。
自动为我们添加了资源类型为“WAVE”的资源IDR_WAVE1,在此我修改其ID为IDR_WAVE。但请注意,WAVE类型并不是标准资源类型,而是自定义资源类型。
HelloWindows.rc和resource.h文件的相关部分如下所示:
IDR_WAVE WAVE "站着等你三千年.wav"
#define IDR_WAVE 108
自定义资源的资源类型可以随意修改,所对应的文件也可以随意指定为其他文件,或随意编辑文件内容。
现在,我们已经为程序添加了一首歌曲资源,在程序运行以后,将这首歌曲加载到内存中并播放:
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
HRSRC hResBlock;
HANDLE hRes;
LPVOID lpMusic;
switch (uMsg)
{
case WM_CREATE:
hResBlock = FindResource(g_hInstance, MAKEINTRESOURCE(IDR_WAVE), TEXT("WAVE"));
hRes = LoadResource(g_hInstance, hResBlock);
lpMusic = LockResource(hRes);
PlaySound((LPCTSTR)lpMusic, NULL, SND_MEMORY | SND_ASYNC | SND_LOOP);
return 0;
case WM_DESTROY:
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
编译运行程序,歌声响起来。完整代码参见Chapter6\HelloWindows7。当然也可以先释放到本地再进行播放,只需要一个创建文件的函数调用即可。如果自定义数据比较重要,就需要数据加密,否则很容易被他人提取出原始资源文件。
FindResource或FindResourceEx函数可以获取模块中具有指定类型和名称的资源:
HRSRC WINAPI FindResource(
_In_opt_ HMODULE hModule, // 模块句柄
_In_ LPCTSTR lpName, // 资源名称,通常使用MAKEINTRESOURCE
_In_ LPCTSTR lpType); // 资源类型名称
如果函数执行成功,则返回值是指定资源信息块的句柄;如果函数执行失败,则返回值为NULL,要获取错误信息,请调用GetLastError:
DWORD GetLastError(void);// 返回错误代码,例如0表示操作成功完成,1功能错误,2找不到指定的文件
有时候,程序的书写错误可能不容易被发现,这时候就需要不断调试。很多API函数在执行失败以后会设置错误代码,因此我们可以通过调用GetLastError获取最近的函数调用的错误代码,找到函数调用的错误原因。假设FindResource函数调用的第3个参数lpType是错误的:
hResBlock = FindResource(g_hInstance, MAKEINTRESOURCE(IDR_WAVE), TEXT("WAV"));
那么可以在不确定的代码前面设断点。此处我就在上面这一行上按F9键设置断点,然后按F5键调试运行。在断点处暂停运行后,单击VS菜单栏的调试→窗口→监视→监视1,把监视窗口调出来,然后可以在VS底部看到监视1窗口,在名称一栏输入“$err,hr”。然后,按F10键单步执行,监视窗口如原书的图6.20所示。
“err,hr”就是在监视窗口查看上一次函数调用错误代码的命令,同时把详细信息也显示出来。如果是err,hr”就是在监视窗口查看上一次函数调用错误代码的命令,同时把详细信息也显示出来。如果是err,hr”就是在监视窗口查看上一次函数调用错误代码的命令,同时把详细信息也显示出来。如果是err,则仅显示一个数字形式的错误代码编号。通过上面的错误提示,我们很容易知道是资源类型名称写错了。有的API函数在执行失败后可能不会设置错误代码,就不能通过这个方法找错误原因了。究竟能不能通过GetLastError函数获取错误代码,MSDN都会有说明。
想跟踪哪个变量,可以在监视窗口中输入变量名称,例如想看一下执行lpMusic = LockResource (hRes);这一句代码后lpMusic的值,如原书的图6.21所示。
想知道lpMusic指向的内存数据,可以复制lpMusic的内存地址值粘贴到内存1窗口中进行查看。自动窗口显示的是最近用到的变量值。
实际上,LoadAccelerators、LoadCursor、LoadIcon、LoadMenu、LoadString、LoadBitmap等资源加载函数在内部都调用了FindResource函数。想要跟踪一个API函数在内部调用了哪些函数,需要使用调试符号文件(.pdb)。调试符号文件是编译器在将源文件编译为可执行文件的时候为了支持调试而保存的调试信息,包括变量名、函数名和源代码行等。通常我们编译程序的时候也会生成一个.pdb文件。
单击VS菜单栏的调试→选项,打开选项对话框。选择调试→符号,勾选Microsoft符号服务器,也可以同时勾选NuGet.org符号服务器,在此目录下缓存符号(C):中选择一个文件夹进行存放。在一开始,每次进行调试的时候,都会从微软服务器下载相应的符号文件,速度比较慢,还会导致VS软件很卡,但是随着以后不断写程序,不断调试,本地符号文件会越来越多,所以基本上不需要再从微软服务器进行下载,那时候速度就很快了。但是2020年以后,微软好像已经不再提供符号文件的下载了。
在WinMain函数的HMENU hMenu = LoadMenu(hInstance, MAKEINTRESOURCE(IDR_MENU));一行设置断点,按F5键调试运行。在断点处暂停运行后,切换到反汇编窗口,如原书的图6.22所示。
按F10键单步执行,到call dword ptr [impLoadMenuW@8 (09206Ch)]这一行,按F11键单步执行。F10和F11都是单步执行,区别是F11遇到call会进入内部,而F10不会。按F11键进入这个call,如原书的图6.23所示。
如果没有调试符号文件,call dword ptr [_pfnFindResourceExW (759500D8h)]的显示如原书的图6.24所示。
把FindResource函数返回的资源信息块的句柄hResBlock作为参数调用LoadResource函数,即可得到资源的句柄:
HGLOBAL WINAPI LoadResource(
_In_opt_ HMODULE hModule, // 模块句柄
_In_ HRSRC hResInfo); // FindResource或FindResourceEx函数返回的资源信息块句柄
如果函数执行成功,则返回值是资源的句柄;如果函数执行失败,则返回值为NULL。
要获取内存中资源数据的指针,还需要把LoadResource函数返回的资源句柄hRes作为参数调用LockResource函数:
LPVOID WINAPI LockResource(_In_ HANDLE hResData);
要获取资源的大小,可以在调用FindResource函数以后调用SizeofResource(g_hInstance, hResBlock);,函数返回值是DWORD类型的资源大小。
在使用资源后不需要手动释放,当不再需要的时候系统会自动释放。
88



被折叠的 条评论
为什么被折叠?



