loadMenuA 函数 (winuser.h)

  • 项目

从与应用程序实例关联的可执行文件 (.exe) 文件加载指定的菜单资源。

语法

HMENU LoadMenuA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpMenuName
);

参数

[in, optional] hInstance

类型： HINSTANCE

包含要加载的菜单资源的模块的句柄。

[in] lpMenuName

类型： LPCTSTR

菜单资源的名称。 或者，此参数可以包含低序字中的资源标识符和高序字中的零。 若要创建此值，请使用 MAKEINTRESOURCE 宏。

返回值

类型： HMENU

如果函数成功，则返回值是菜单资源的句柄。

如果函数失败，则返回值为 NULL。 要获得更多的错误信息，请调用 GetLastError。

注解

在应用程序关闭之前， DestroyMenu 函数用于销毁菜单并释放加载的菜单占用的内存。

示例

有关示例，请参阅 显示快捷菜单

注意

winuser.h 标头将 LoadMenu 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.14 (393 中引入的 ext-ms-win-ntuser-menu-l1-1-3)

请参阅

概念性

LoadMenuIndirect

MAKEINTRESOURCE

菜单

引用