【Windows】《深入浅出Windows API程序设计:编程基础篇》笔记-Chapter6-菜单和其他资源

学习win32 API开发6-给窗口添加菜单 看到别人做菜单有很多种,而我就比较不要麻烦就用较简单的来学习下吧,好用就行了。 一、用编辑资源来添加菜单 我用的VC++6.0,VS2013也是一样的!其他的工具嘛,没有用, 不知道。 先插入或者说添加一个类型为菜单(MENU)的资源文件,然后就保存下,保存到当前项目的目录下面,然后编辑这个资源文件,资源文件的后缀名是“.rc”,把菜单资源的ID改好。 现在添加菜单项吧,就做个简单的,比如 阅读详情

第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菜单项ID0
加速键1菜单项ID0
子窗口控件通知码控件ID控件句柄

后面再讲子窗口控件的命令消息。通常,不在乎是菜单命令项还是加速键发送过来的WM_COMMAND消息,也就是不用区分HIWORD(wParam),只需要区分LOWORD(wParam)来根据不同的菜单项ID作出不同的处理。

当用户单击了系统菜单中的命令项或按下了系统菜单的加速键,又或者单击了最小化、最大化、恢复、关闭按钮时,窗口过程会收到WM_SYSCOMMAND消息。程序通常不应该处理WM_SYSCOMMAND消息,而是交给DefWindowProc函数执行默认处理。

  • WM_SYSCOMMAND消息的wParam参数包含请求的系统命令类型,常见的值如表6.3所示。

表6.3

常量值含义
SC_MINIMIZE0xF020最小化窗口
SC_MAXIMIZE0xF030最大化窗口
SC_RESTORE0xF120将窗口恢复到正常位置和大小
SC_CLOSE0xF060关闭窗口
SC_SIZE0xF000调整窗口大小
SC_MOVE0xF010移动窗口
SC_HSCROLL0xF080水平滚动
SC_VSCROLL0xF070垂直滚动
SC_HOTKEY0xF150全局热键消息

可以看到系统命令类型实际上使用的是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_SYSTEMWindows图标或在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_TABTab控件
  • 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类型的资源大小。

在使用资源后不需要手动释放,当不再需要的时候系统会自动释放。

Windows api资源篇 WIndows的资源有: Icons Cursors Character strings Custom resources Menus Keyboard accelerators Dialog boxes Bitmaps 阅读详情

相关推荐

5、Windows菜单编程全解析

本文详细解析了Windows菜单编程的核心内容,涵盖菜单基础、在资源文件中定义菜单、将菜单附加到窗口、动态修改菜单以及各种Win32 API提供的菜单支持函数。通过示例代码和函数说明,帮助开发者掌握如何创建、管理和响应Windows应用程序中的菜单操作。此外,还介绍了菜单消息处理机制和加速器表的使用,为开发功能丰富、交互性强的应用程序提供了全面指导。

sea99的博客 88

Windows API函数大全(Windows编程参考手册)

文档声明: 以下资料均属于本人在学习过程中产出的学习笔记,如果错误或者遗漏之处,请多多指正。并且该文档在后期会随着学习的深入不断补充完善。感谢各位的参考查看。 笔记资料仅供学习交流使用,转载请标明出处,谢谢配合。 如果存在相关知识点的遗漏,可以在评论区留言,看到后将在第一时间更新。 作者:Aliven888 ...

eli的博客 2万+

Windows编程 - 菜单解析

HWND hWnd = CreateWindowEx(0, __TEXT("Main"), __TEXT("主窗口"), WS_OVERLAPPEDWINDOW, 800, 300, 600, 600, NULL, NULL, hIns, NULL);//当前程序实例句柄。if (GetMessage(&nMsg, NULL, 0, 0)) //捕获消息。if (PeekMessage(&nMsg, NULL, 0, 0, PM_NOREMOVE)) //侦查消息。

weixin_50920631的博客 210

【Windows】《深入浅出Windows API程序设计:编程基础篇》笔记-Chapter1-基础知识

本书是Windows API程序设计的入门图书,提供大量的示例程序,主要介绍学习Windows程序设计必备的基础知识,以及一个程序界面所需的菜单、图标光标、子窗口控件、其他资源和对话框等相关内容,并通过Photoshop切片和自绘技术实现一个优雅的程序界面。通过阅读本书,读者可以对Windows程序设计有更加深入的认识,并将其应用到实际场景中。

江湖人称菠萝包 314

《Windows程序设计》第五版中文英文双语教材

Windows API(Application Programming Interface)是微软为开发者提供的一套应用程序接口,其使得开发者能够在Windows操作系统上进行程序设计。Windows API是构建在操作系统底层功能之上的接口,允许开发者访问系统资源和执行高级操作。

weixin_42298254的博客 878

关于并网继电器的继电器自检逻辑及实现方式

对于常规的光伏并网逆变器来说,继电器控制至关重要。继电器一般位于逆变电感后,共模电感前,用于将逆变电压与电网电压脱开,一般国外有双继电器的安规强制认证要求,国内目前只需要单继电器要求(后续应该会有双继电器要求,个人感觉)

weixin_29982209的博客 2621

【Windows】《深入浅出Windows API程序设计:编程基础篇》笔记-Chapter9-对话框

在图形用户界面中,对话框是一种特殊的窗口,用来向用户显示信息(例如MessageBox消息框),或者在需要的时候获得用户的输入以作出响应(例如记事本Notepad的查找、替换对话框)。之所以称之为“对话框”,是因为它们使计算机和用户之间构成了一个对话:通知用户一些信息,或者是请求用户的输入,又或者两者皆有。通常在可以打开对话框的菜单项后面加上“…”,例如“文件”菜单下的“另存为…”表示会打开一个选择文件名的对话框。对话框中的按钮、文本框和图标等称为“子窗口控件”。

江湖人称菠萝包 613

SAP中贸易伙伴的应用原理简析

公司也称为贸易伙伴,是出具合并报表的组织单位,可以为客户和供应商分配公司(贸易伙伴),用于识别集团内关闻公司间的业务往来,在编制合并报表时进行往来账务的计算处理。 如下图某贸易伙伴公司(关联方名称G0059)在我方公司的SAP系统中有多重身份(即是供应商,又是客户)。那么在我方公司SAP系统中建立起公司(贸易伙伴),并关联到供应商和客户主数据中。之后,就可以通过G0059这个贸易伙伴名称来识别与该贸易伙伴间的往来业务。 相应的配置设定如下: 定义公司(贸易伙伴或关联方) 会计凭证中会

专注SAP应用技术文章写作,致力于拉近用户与系统间的距离; 9818

【Windows】《深入浅出Windows API程序设计:编程基础篇》笔记-Chapter8-子窗口控件

工具栏具有简单、直接、美观的特点,但是如果菜单项比较多,想要全部显示可能会占据大量的空间。为此可以在调用CreateWindowEx函数创建工具栏时指定CCS_ADJUSTABLE样式启用工具栏的自定义功能,用户可以自由排列工具栏按钮,或者仅选择显示用户感兴趣的按钮。在指定CCS_ADJUSTABLE样式后,用户可以将按钮拖动到新位置或通过将其拖离工具栏来删除按钮(按住Shift键)。此外,当用户双击工具栏的时候,会弹出一个自定义工具栏对话框,如原书的图8.23所示。

江湖人称菠萝包 477

5分钟看懂LTE注网全流程:从PLMN选择到小区驻留的log分析技巧

本文深入解析了LTE终端从开机到成功驻留小区的完整流程,重点分享了基于QXDM和QCAT工具的log分析实战技巧。文章详细拆解了PLMN选择、System/Band扫频、小区搜索与同步、系统消息解析及驻留等关键步骤,并提供了高频问题场景的排查思路,帮助网络优化工程师快速定位终端侧、射频环境或网络配置问题。

app77的博客 435

CVPR 2027 投稿规划:基于近3年录用率与截稿周期的5步时间管理法

本文为计算机视觉研究者提供CVPR 2027投稿的完整规划指南,基于近三年录用率与截稿周期数据,提出五步时间管理法。涵盖选题策略、实验设计、论文写作、同行评审到最终提交的全流程优化,特别针对CVPR日益激烈的竞争环境(2024年投稿量达11532篇,录取率仅23.6%)提供实用解决方案,帮助研究者提升投稿成功率。

weixin_34079177的博客 1186

浅谈 Windows API 编程

原文地址:http://blog.sina.com.cn/s/blog_46d85b2a01010qpt.html http://blog.sina.com.cn/s/articlelist_1188584234_0_1.html WinSDK 是编程中的传统难点,曾经听有一个技术不是很好的朋友乱说什么给你 API 谁都会用,其实并非那么简单,个人写的WinAPI 程序也不少了,其...

freeking101的博客 9910

【深度学习】最强算法之:残差网络(ResNet)

一篇掌握深度学习算法之:残差网络

商务合作 | 面试培训 | 职场规划 ==>主页扫码 7840

Win32编程API 基础篇 -- 6.菜单和图标

菜单和按钮 例子:菜单1   本小节仅仅向你展示如果向你的窗口中加入一个基本的菜单,通常你会用到一个提前制作好的菜单资源,这会是一份.rc文件并且会被编译链接进你的.exe可执行程序中。这是具体的流程做法,而商业编译器将会有一个资源编辑器,你可以通过这个编辑器来创建菜单,但是在这个例子中我会向你展示如何用.rc文件的手动写法。通常我会配合使用一个头文件,在资源文件和源文件中我们...

denggu4196的博客 445

5.17华为OD机试真题 新系统 - 输出二叉树后序遍历结果 (Java/Py/C/C++/Js/Go)

5.17华为OD机试真题 新系统 - 输出二叉树后序遍历结果 (Java/Py/C/C++/Js/Go)

算法大师! 520

什么是 SAPGUI 里的 Logon Group/Server

这意味着,不同的用户连接可以被分配到不同的应用服务器,以实现均衡的资源利用和降低某一服务器的负载压力。在这种配置下,欧洲的用户登录时选择“EUROPE_GROUP”,系统将自动选择一个位于欧洲的数据中心的服务器进行连接,这样不仅减少了网络延迟,还实现了服务器间的负载均衡。用户在 SAPGUI 中登录时,只需选择相应的 Logon Group(例如“FIN_GROUP”),系统就会自动将他们的连接请求分配到当前负载最小的应用服务器上,这种动态分配大大提升了系统的响应速度和稳定性。

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 1073

【Windows】《深入浅出Windows API程序设计:核心编程篇》笔记-Chapter6-动态链接库

程序中用到的Windows API函数都包含在动态链接库(Dynamic Link Library,DLL)中,其中3个最重要的动态链接库(DLL)分别是Kernel32.dll、User32.dll和Gdi32.dll。Kernel32.dll中包含的函数用来管理内存、进程以及线程等,User32.dll中包含的函数用来执行与用户界面相关的任务,例如创建窗口和发送消息等,Gdi32.dll中包含的函数用来绘制图像和显示文字等。

江湖人称菠萝包 286

CosyVoice语音合成使用教程

CosyVoice是一款开源的语音合成工具,它基于深度学习模型,能够生成高度逼真的语音内容。该工具支持多种语言的语音生成,包括中文、英文、日文、粤语和韩语。CosyVoice的亮点在于它对生成语音情感和韵律的精细控制,通过富文本或自然语言输入,可以显著提升合成语音的情感表达能力。CosyVoice提供了多种预训练模型,用户可以根据需求选择合适的模型。:基底模型,适用于一般语音合成任务。:经过SFT微调的模型,适用于特定音色和情感的语音合成。:支持Instruct微调的模型,适用于自然语言控制的语音合成。

笔者从事电信媒体开发多年,愿意将多年的开发经验分享给同行 4445

Windows程序设计最新书籍教程

深入浅出Windows API程序设计编程基础篇和核心编程篇

huaqiang56的博客 690

efm32 入门.pdf

本PDF共计22页,介绍的是操作驱动API,下载与否自己斟酌。

SAP B1中文培訓教材_SDK

公司内部培训资料,对开发工具 ,DIAPI, UIAPI,Add-ON有详细解说

Win32创建菜单篇

一、知识准备: 菜单 ----- 每个菜单会有一个HMENU句柄 菜单项 ------ 每个菜单项会有一个ID号,可以根据这个ID执行不同的操作。 菜单一般分为三种:系统菜单、顶层菜单、弹出菜单(右键菜单)。 系统菜单: 程序左上角的图标点击鼠标左键、或者在标题栏点击鼠标右键,出现的就是系统菜单。主要内容有:还原、移动、大小、最小化、最大化、关闭。 顶层菜单: 一般出现在程序左上角位置。 弹出菜单: 程序的窗口中点击鼠标右键(必要的时候左键也可以)弹出的菜单,或者顶层菜单点击后出现的菜单,都称为弹出式菜单

程序员战胜 5592

Devexpress16.2.6破解工具

Devexpress16.2.6破解工具Devexpress16.2.6破解工具Devexpress16.2.6破解工具Devexpress16.2.6破解工具

Windows API编程(一)最基础的知识介绍:Windows编程基础

主要内容简介: 1. Windows 编程基础:开发环境和开发过程。 2. Windows事件驱动模型和消息机制。 3. Windows的资源:图标、光标、菜单、位图等。 4. Windows绘图:图形和文字的显示。 5. 对话框和控件。 6. 静态库和动态库。 7. Windows的内存管理。 8. Windows文件系统。 9. Windows的进程管理。 ...

无名的博客 3567

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

Windows API 程序设计入门

目录目的:最初了解Windows API编程,从创建窗口开始,步骤:具体代码如下:运行结果 目的: 1.了解Windows操作系统程序开发的基本概念,win32API函数、消息与事件驱动; 2.掌握WinMain函数的基本框架,窗口定义、窗口创建、消息循环及窗口过程函数; 最初了解Windows API编程,从创建窗口开始,步骤: 1.mainwidow函数 2.设计窗口类 3.注册窗口类 4.创建窗口 5.更新窗口 6.消息处理 7.过程调用 具体代码如下: #include "resource.h"//

weixin_45189408的博客 1034

Windows菜单的三种创建方法

菜单是窗体上的重要构件,是人机交互的重要工具。菜单由菜单条、子菜单、菜单项三个要素构成。 菜单条可以理解为"横式"菜单条,子菜单可以理解为"纵式"菜单条。因为"纵式"菜单条常挂入到其他菜单条中,这种情况称为子菜单;如果作为独立的快捷菜单使用,这种情况称为快捷菜单。 创建Windows菜单有三种方法,即资源编辑、内存菜单模板和动态创建。这三种方法可以独立使用,也可以结合使用。下面分别介绍。

hzj58477的博客 3510

windows菜单等常用资源设置

在现在的环境下,在VC下编程,大家都已经习惯了使用MFC的快捷,对于资源文件的处理很多人都已经不了解了,我写这篇文章,主要就是为了对VC下资源文件的处理进行一个简单的解说。 一.添加图标icon 第一种,通过ID进行添加wndclass.hIcon         = LoadIcon (hInstance, MAKEINTRESOURCE (IDI_ICON1)) ;这里

Ckary的博客 1017

Python+Agent入门笔记(六):记忆和状态,从“一次性问答”到“能用助手”

滑动窗口的缺点很明显:被扔掉的信息就真没了。如果用户第一轮说“我不吃辣”,隔了二十轮让他推荐餐厅,模型已经忘了。定期把旧的对话压缩成一段总结,作为一条特殊的消息插进去。"""把除 system 和最近 keep_recent 条以外的消息,压缩成一条摘要。返回新的 messages 列表。"""# 把旧消息拼成纯文本,让模型总结content = f"[工具结果]把除 system 和最近 keep_recent 条以外的消息,压缩成一条摘要。返回新的 messages 列表。

qq_41241612的博客 117
上一篇: 【Windows】《深入浅出Windows API程序设计:编程基础篇》笔记-Chapter5-计时器(定时器)和时间
下一篇: 【Windows】《深入浅出Windows API程序设计:编程基础篇》笔记-Chapter7-位图
江湖人称菠萝包
博客等级 码龄10年 762粉丝 314原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值