Función GetSystemMenu (winuser.h)

Artículo
03/15/2023

Permite a la aplicación acceder al menú de la ventana (también conocido como menú del sistema o el menú de control) para copiar y modificar.

Sintaxis

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

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana que poseerá una copia del menú de la ventana.

[in] bRevert

Tipo: BOOL

Acción que se va a realizar. Si este parámetro es FALSE, GetSystemMenu devuelve un identificador a la copia del menú de la ventana actualmente en uso. La copia es inicialmente idéntica al menú de la ventana, pero se puede modificar. Si este parámetro es TRUE, GetSystemMenu restablece el menú de la ventana al estado predeterminado. El menú de la ventana anterior, si existe, se destruye.

Valor devuelto

Tipo: HMENU

Si el parámetro bRevert es FALSE, el valor devuelto es un identificador de una copia del menú de la ventana. Si el parámetro bRevert es TRUE, el valor devuelto es NULL.

Comentarios

Cualquier ventana que no use la función GetSystemMenu para realizar su propia copia del menú de la ventana recibe el menú de ventana estándar.

El menú de la ventana contiene inicialmente elementos con varios valores de identificador, como SC_CLOSE, SC_MOVE y SC_SIZE.

Los elementos de menú del menú de la ventana envían mensajes WM_SYSCOMMAND .

Todos los elementos de menú de ventana predefinidos tienen números de identificador mayores que 0xF000. Si una aplicación agrega comandos al menú de la ventana, debe usar números de identificador inferiores a 0xF000.

El sistema grisiza automáticamente los elementos en el menú de la ventana estándar, dependiendo de la situación. La aplicación puede realizar su propia comprobación o atenuación respondiendo al mensaje WM_INITMENU que se envía antes de que se muestre cualquier menú.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-menu-l1-1-0 (introducido en Windows 8)