GetSystemMenu

小甲鱼

注：本文档由 n0noper 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

GetSystemMenu 函数用于允许应用程序为复制或修改而访问窗口菜单（系统菜单或控制菜单）。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HMENU WINAPI GetSystemMenu(
  _In_ HWND hWnd,
  _In_ BOOL bRevert
);

参数解析：

参数	含义
hWnd	指向拥有窗口菜单拷贝的窗口的句柄
bRevert	1. 指定将要执行的动作 2. 如果该参数为 FALSE，GetSystemMenu 函数会返回正在使用的窗口菜单的拷贝的句柄。该拷贝在初始化时与窗口菜单相同，但可以被修改 3. 如果该参数为 TRUE，GetSystemMenu 函数会重新设置窗口菜单为默认状态，之前的窗口菜单将会被销毁

返回值：

1. 如果 bRevert 参数为 FALSE，返回值是窗口菜单拷贝的句柄；

2. 如果 bRevert 参数为 TRUE，返回值为 NULL。


备注：

1. 任何没有使用 GetSystemMenu 函数来生成自己的窗口菜单拷贝的窗口会接受标准窗口菜单。

2. 窗口菜单初始时包含不同的标识符值，如 SC_CLOSE, SC_MOVE 和 SC_SIZE。

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

4. 所有预定义窗口菜单项的 ID 值都大于 0xF000。如果应用程序添加命令到窗口菜单，应该使用小于 0xF000 的 ID 值。

5. 系统将根据状态自动灰化标准窗口菜单的菜单项。应用程序将会响应在任何菜单显示之前发送的 WM_INITMENU 消息来执行选中或灰化。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Library	User32.lib
DLL	User32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。