Win32 API中CreateWindowEx的HMENU参数合法设置方法咨询

问题原因 #

你遇到的窗口不显示问题核心是对CreateWindowEx函数的HMENU参数语义理解错误：

• 当创建不带WS_CHILD风格的顶层窗口时，HMENU参数表示窗口关联的菜单栏句柄，你传入的(HMENU)-1不是合法的菜单句柄，会导致CreateWindowEx调用失败返回NULL，后续ShowWindow执行无效，自然没有窗口显示，只有消息循环运行所以进程残留。
• 当创建带WS_CHILD风格的子控件窗口时，HMENU参数才可以传入自定义的整数控件ID（需强制转换为HMENU类型）。

合法设置HMENU的两种场景 #

1. 顶层窗口关联菜单栏 #

如果你的顶层窗口需要菜单栏，有两种合法获取HMENU的方式：

• 从工程资源加载预定义的菜单：

// 假设你的资源文件中定义了ID为IDR_MAIN_MENU的菜单资源
HMENU hMenu = LoadMenu(mainHinst, MAKEINTRESOURCE(IDR_MAIN_MENU));
mainWindow = CreateWindowEx(
        0, className,
        "変態",
        WS_BORDER | WS_CAPTION | WS_MINIMIZEBOX | WS_SYSMENU,
        CW_USEDEFAULT, CW_USEDEFAULT, 640, 480,
        nullptr, hMenu, mainHinst, nullptr
);

• 代码动态创建菜单：

// 构造菜单栏
HMENU hMainMenu = CreateMenu();
HMENU hFileMenu = CreatePopupMenu();
AppendMenu(hFileMenu, MF_STRING, 1001, "退出");
AppendMenu(hMainMenu, MF_POPUP, (UINT_PTR)hFileMenu, "文件");

// 传入CreateWindowEx
mainWindow = CreateWindowEx(
        0, className,
        "変態",
        WS_BORDER | WS_CAPTION | WS_MINIMIZEBOX | WS_SYSMENU,
        CW_USEDEFAULT, CW_USEDEFAULT, 640, 480,
        nullptr, hMainMenu, mainHinst, nullptr
);

如果顶层窗口不需要菜单栏，直接传入NULL/nullptr即可。

2. 子控件设置ID #

创建按钮、输入框等子控件时，需要给窗口加上WS_CHILD风格，此时可以将自定义的整数ID强转为HMENU传入，用于后续区分不同控件的事件：

// 创建ID为2001的按钮
HWND hTestBtn = CreateWindowEx(
        0, "BUTTON", "测试按钮",
        WS_CHILD | WS_VISIBLE | BS_PUSHBUTTON,
        20, 20, 120, 30,
        mainWindow, (HMENU)2001, mainHinst, nullptr
);

附加建议 #

后续调用Win32 API时建议增加返回值判断，比如CreateWindowEx调用后判断返回值是否为NULL，如果失败可以调用GetLastError获取错误码快速定位问题。

内容的提问来源于stack exchange，提问作者Someone