Win32 编程基础之资源

载入属性指定了资源何时被载入。它可以是下面中的一个：

menuitem 的语法是：

MENUITEM text, result, [optionlist]
MENUITEM SEPARATOR

text 是菜单项的名字，它可以包含 \t 和 \a。\t 会在字符串中插入一个 tab，它被用来列对其文本。tab 字符只应该在菜单中使用，不应该在菜单栏中使用。\a 字符将所有的文本右对其。

result 是当用户选择菜单项时产生的结果值。结果值总是整数；用户点击菜单项名字时，结果值会被发送到拥有菜单的窗口。

optionlist 控制菜单项的外观。选项参数可以是一个或多个下面的值，使用空格和逗号分开。

• CHECKED，在菜单项旁边有一个选择标记
• GRAYED，菜单项初始时是不活跃的，以灰色外观出现在菜单上。这个选项不能和 INACTIVE 一起使用
• HELP，标识一个帮助项。这个选项对菜单项的外观没有任何影响
• INACTIVE，菜单项被显示，但是它不能被选取。它不能和 GRAYED 一起使用
• MENUBARBREAK，和 MENUBREAK 一样，使用垂直线将新的列和老的列分开
• MENUBREAK，将菜单项放在新的列

MENUITEM SEPARATOR 创建一个不活跃的菜单项，它将两个活跃的菜单项分开。

定义一个包含菜单项和子菜单的菜单项。

POPUP text, [optionlist] {item-definitions ...}

text 是菜单项的名字，它必须在双引号内。

optionlist 和 上面的 MENUITEM 的选项一致。

补充：在菜单项字符串中还可以使用 & 符号，使得紧跟 & 的下一个字符可以显示下划线。

资源文件支持 C 风格的单行注释，也支持块注释。块注释以 /* 开头，以 */ 结尾。

下面是一个 rc 文件的注释例子：

/*
    Resources.Rc

    Contains the resource definitions for the application.
    Control identifiers are defined in Resources.h.
*/

#include "resources.h"
//...

资源文件不支持 ANSI C 的预定义宏。因此，你不能在资源脚本中使用它们。

你可以在资源脚本中使用以下的一定义指令。它们与 C 语言的预定义指令很相似：

关于菜单的消息有很多，以下随便列举几个

WM_MENUSELECT，当用户在菜单项之间移动光标或鼠标时，程序可以接收到许多 WM_MENUSELECT 消息。这对于实现一个状态栏十分有用，因为可以在状态栏上显示菜单的完整文本描述。

WM_INITMENUPOPUP，Windows 要显示菜单时，会向窗口发送一个该消息。

最重要的是 WM_COMMAND 消息，它表示用户已经从窗口菜单中选择了一个被启用的菜单项。

wParam 参数的 LOWORD 是菜单的 ID， lParam 是 0。

程序可以在窗口类定义中引入菜单，这里假设菜单名存储在 szMenuName 变量中，wndclass 是 WNDCLASS 类型的变量，那么可以这样做：

wndclass.lpszMenuName = szMenuName

应用还可以使用 LoadMenu 函数把资源载入到内存。 LoadMenu 返回一个菜单句柄，它可以在 CreateWindow 中使用。也可以在 CreateWindow 后使用 SetMenu 来指定一个菜单。

CheckMenuItem 可以设置指定菜单项的点击属性。

函数原型如下：

DWORD CheckMenuItem(
  HMENU hMenu,
  UINT  uIDCheckItem,
  UINT  uCheck
);

uCheck 的值可以是 MF_BYCOMMAND，MF_BYPOSITION，MF_CHECKED 或 MF_UNCHECKED。可以控制菜单的外观是否为点击外观。

EnableMenuItem 函数可以设置菜单项的可用状态。

BOOL EnableMenuItem(
  HMENU hMenu,
  UINT  uIDEnableItem,
  UINT  uEnable
);

uEnable 的值可以是 MF_BYCOMMAND，MF_BYPOSITION，MF_DISABLED，MF_ENABLED 和 MF_GRAYED。

GetMenu 可以通过窗口句柄获得菜单句柄，SetMenu 可以为某个窗口设置菜单。

CreateMenu 创建一个新的空菜单，并返回菜单句柄。

AppendMenu 在菜单末尾加上一个新的菜单项。

DeleteMenu 从菜单中删除菜单项并进行销毁

InsertMenu 在菜单中插入一个新菜单项

ModifyMenu 修改一个已存在的菜单项

RemoveMenu 从菜单中去除一个已有的菜单项

GetMenuItemCount 可以获得菜单中现有菜单项的个数

GetMenuItemID 可以根据弹出菜单的位置获得某个菜单项的 ID

这里举一个简单的例子，它使用三个菜单项，分别叫做 One，Two，Three。鼠标按下菜单项时，会在客户区的左上角打印对应于菜单的 1，2，3 三个数字。按下一个菜单项后，该菜单项外观会被标记为按下状态。若点击处于按下状态的菜单项，那么数字会被擦除。

以下是资源文件的头文件和脚本文件

//resource.h
#define IDR_MENU1                       129
#define ID_NUMBER_ONE                   32771
#define ID_NUMBER_TWO                   32772
#define ID_NUMBER_THREE                 32773

//resource.rc
IDR_MENU1 MENU
BEGIN
    POPUP "Number"
    BEGIN
        MENUITEM "One",                         ID_NUMBER_ONE
        MENUITEM "Two",                         ID_NUMBER_TWO
        MENUITEM "Three",                       ID_NUMBER_THREE
    END
END

接下来，在注册窗口类时加上自定义的菜单标识符：

wcex.lpszMenuName   = MAKEINTRESOURCEW(IDR_MENU1);

以下部分是窗口过程：

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    static int iCurrNum;
    static int IDmap3[3] = { ID_NUMBER_ONE, ID_NUMBER_TWO, ID_NUMBER_THREE };
    HMENU hMenu;
    switch (message)
    {
    case WM_COMMAND:
        {
            hMenu = GetMenu(hWnd);
            int wmId = LOWORD(wParam);
            if (iCurrNum >= 1)
                CheckMenuItem(hMenu, IDmap3[iCurrNum - 1], MF_UNCHECKED);
            switch (wmId)
            {
            case ID_NUMBER_ONE:
                if (iCurrNum != 1)
                {
                    CheckMenuItem(hMenu, ID_NUMBER_ONE, MF_CHECKED);
                    iCurrNum = 1;
                }
                else
                    iCurrNum = 0;
                break;
            case ID_NUMBER_TWO:
                if (iCurrNum != 2)
                {
                    CheckMenuItem(hMenu, ID_NUMBER_TWO, MF_CHECKED);
                    iCurrNum = 2;
                }
                else
                    iCurrNum = 0;
                break;
            case ID_NUMBER_THREE:
                if (iCurrNum != 3)
                {
                    CheckMenuItem(hMenu, ID_NUMBER_THREE, MF_CHECKED);
                    iCurrNum = 3;
                }
                else
                    iCurrNum = 0;
                break;
            default:
                return DefWindowProc(hWnd, message, wParam, lParam);
            }
        }
        InvalidateRect(hWnd, NULL, TRUE);
        break;
    case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hWnd, &ps);
            if (iCurrNum == 1)
            {
                TextOut(hdc, 0, 0, TEXT("1"), 1);
            }
            else if (iCurrNum == 2)
            {
                TextOut(hdc, 0, 0, TEXT("2"), 1);

            }
            else if (iCurrNum == 3)
            {
                TextOut(hdc, 0, 0, TEXT("3"), 1);
            }

            EndPaint(hWnd, &ps);
        }
        break;
    case WM_DESTROY:
        PostQuitMessage(0);
        break;
    default:
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}

运行并点击菜单，可以在左上角相应显示 1，2，3 三个数字。

以上的资源文件并非我直接写在文件中，而是通过 VS 的自动生成功能得到的。

在应用中使用 LoadAccelerators 来把加速键表加载到内存中，并获得它的句柄。

HACCEL hAccel = LoadAccelerators (hInst, MAKEINTRESOURCE(IDA_ACCE));

要使用加速键，需要对主循环进行修改，将

while (GetMessage(&msg, NULL, 0, 0))
{
    TranslateMessage(&msg);
    DispatchMessage(&msg);
}

修改为

while(GetMessage(&msg, NULL, 0, 0))
{
    if (!TranslateAccelerator(hWnd, hAccel, &msg))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
}

TranslateAccelerator 函数确定在 msg 消息结构中的消息是否为键盘消息。如果是，它会在加速键表中寻找句柄为 hAccel 的匹配值。如果找到了，它会调用 hWnd 的窗口过程。如果键盘加速键 ID 对应于系统菜单的一个菜单项，则对应消息为 WM_SYSCOMMAND，否则为 WM_COMMAND。

如果键盘加速键对应于某个菜单项，那么创口过程还会接收到 WM_INITMENU，WM_INITMENUPOPUP 和 WM_MENUSELECT 消息。如果窗口被最小化，对于映射到启用的系统菜单项的键盘加速键，TranslateAccelerator 会发送 WM_SYSCOMMAND 而不是 WM_COMMAND。

加速键的 WM_COMMAND 消息中，LOWORD(wParam) 是加速键的 ID，HIWORD(wParam) 为 1，lParam 为 0。

下面的例子借用了上面的菜单程序，通过为菜单添加加速键来使用菜单。

资源文件的头文件和脚本文件如下：（仅包含加速键部分）

//resource.h
#define IDR_ACCELERATOR1                130
#define ID_ACCONE                       32774
#define ID_ACCTWO                       32775
#define ID_ACCTHREE                     32776

//resource.rc
IDR_ACCELERATOR1 ACCELERATORS
BEGIN
    "1",            ID_ACCONE,              VIRTKEY, CONTROL, NOINVERT
    "2",            ID_ACCTWO,              VIRTKEY, CONTROL, NOINVERT
    "3",            ID_ACCTHREE,            VIRTKEY, CONTROL, NOINVERT
END

这里使用的是 CONTROL 修饰符，也可以直接在数字前面使用 ^ 而不适用修饰符。

相对于菜单程序，修改后的程序如下：

需要在主循环中添加加速键翻译：

HACCEL hAccelTable = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDR_ACCELERATOR1));

    MSG msg;

    // 主消息循环:
    while (GetMessage(&msg, nullptr, 0, 0))
    {
        if (!TranslateAccelerator(msg.hwnd, hAccelTable, &msg))
        {
            TranslateMessage(&msg);
            DispatchMessage(&msg);
        }
    }

修改后的窗口过程如下：

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    static int iCurrNum;
    static int IDmap3[3] = { ID_NUMBER_ONE, ID_NUMBER_TWO, ID_NUMBER_THREE };
    HMENU hMenu;
    switch (message)
    {
    case WM_COMMAND:
        if (HIWORD(wParam) == 0)
        {
            hMenu = GetMenu(hWnd);
            int wmId = LOWORD(wParam);
            if (iCurrNum >= 1)
                CheckMenuItem(hMenu, IDmap3[iCurrNum - 1], MF_UNCHECKED);
            switch (wmId)
            {
            case ID_NUMBER_ONE:
                if (iCurrNum != 1)
                {
                    CheckMenuItem(hMenu, ID_NUMBER_ONE, MF_CHECKED);
                    iCurrNum = 1;
                }
                else
                    iCurrNum = 0;
                break;
            case ID_NUMBER_TWO:
                if (iCurrNum != 2)
                {
                    CheckMenuItem(hMenu, ID_NUMBER_TWO, MF_CHECKED);
                    iCurrNum = 2;
                }
                else
                    iCurrNum = 0;
                break;
            case ID_NUMBER_THREE:
                if (iCurrNum != 3)
                {
                    CheckMenuItem(hMenu, ID_NUMBER_THREE, MF_CHECKED);
                    iCurrNum = 3;
                }
                else
                    iCurrNum = 0;
                break;
            default:
                return DefWindowProc(hWnd, message, wParam, lParam);
            }
            InvalidateRect(hWnd, NULL, TRUE);
        }
        else
        {
            int accid = LOWORD(wParam);
            switch (accid)
            {
            case ID_ACCONE:
                SendMessage(hWnd, WM_COMMAND, ID_NUMBER_ONE, 0);
                break;
            case ID_ACCTWO:
                SendMessage(hWnd, WM_COMMAND, ID_NUMBER_TWO, 0);
                break;
            case ID_ACCTHREE:
                SendMessage(hWnd, WM_COMMAND, ID_NUMBER_THREE, 0);
                break;
            }
        }

        break;
    case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hWnd, &ps);
            if (iCurrNum == 1)
            {
                TextOut(hdc, 0, 0, TEXT("1"), 1);
            }
            else if (iCurrNum == 2)
            {
                TextOut(hdc, 0, 0, TEXT("2"), 1);

            }
            else if (iCurrNum == 3)
            {
                TextOut(hdc, 0, 0, TEXT("3"), 1);
            }

            EndPaint(hWnd, &ps);
        }
        break;
    case WM_DESTROY:
        PostQuitMessage(0);
        break;
    default:
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}