getSystemMenu 函数 (winuser.h)

使应用程序能够访问窗口菜单 (也称为系统菜单或控件菜单) 进行复制和修改。

语法

HMENU GetSystemMenu(
  [in] HWND hWnd,
  [in] BOOL bRevert
);

参数

[in] hWnd

类型:HWND

将拥有窗口菜单副本的窗口句柄。

[in] bRevert

类型: BOOL

要执行的操作。 如果此参数为 FALSE则 GetSystemMenu 返回当前正在使用的窗口菜单副本的句柄。 副本最初与窗口菜单相同,但可以修改。 如果此参数为 TRUE,GetSystemMenu 会将窗口菜单重置回默认状态。 上一个窗口菜单(如果有)将被销毁。

返回值

类型: HMENU

如果 bRevert 参数为 FALSE,则返回值是窗口菜单副本的句柄。 如果 bRevert 参数为 TRUE,则返回值为 NULL

注解

任何不使用 GetSystemMenu 函数创建自己的窗口菜单副本的窗口都会收到标准窗口菜单。

窗口菜单最初包含具有各种标识符值的项,例如 SC_CLOSESC_MOVESC_SIZE

窗口菜单上的菜单项发送 WM_SYSCOMMAND 消息。

所有预定义的窗口菜单项的标识符号都大于 0xF000。 如果应用程序将命令添加到窗口菜单,它应使用小于 0xF000 的标识符号。

系统根据情况自动将标准窗口菜单上的项灰显。 应用程序可以通过响应显示任何菜单之前发送 的WM_INITMENU 消息来执行自己的检查或灰显。

要求

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

请参阅

概念性

获取菜单

InsertMenuItem

菜单

引用

SetMenuItemInfo

WM_INITMENU

WM_SYSCOMMAND