Funzione GetSystemMenu (winuser.h)

Articolo
03/04/2024

Consente all'applicazione di accedere al menu della finestra (noto anche come menu di sistema o menu di controllo) per la copia e la modifica.

Sintassi

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

Parametri

[in] hWnd

Tipo: HWND

Handle alla finestra che possiede una copia del menu della finestra.

[in] bRevert

Tipo: BOOL

Azione da intraprendere. Se questo parametro è FALSE, GetSystemMenu restituisce un handle alla copia del menu della finestra attualmente in uso. La copia è inizialmente identica al menu della finestra, ma può essere modificata. Se questo parametro è TRUE, GetSystemMenu ripristina lo stato predefinito del menu della finestra. Il menu della finestra precedente, se presente, viene eliminato.

Valore restituito

Tipo: HMENU

Se il parametro bRevert è FALSE, il valore restituito è un handle per una copia del menu della finestra. Se il parametro bRevert è TRUE, il valore restituito è NULL.

Commenti

Qualsiasi finestra che non usa la funzione GetSystemMenu per creare la propria copia del menu della finestra riceve il menu della finestra standard.

Il menu della finestra contiene inizialmente elementi con diversi valori di identificatore, ad esempio SC_CLOSE, SC_MOVE e SC_SIZE.

Le voci di menu del menu della finestra inviano messaggi di WM_SYSCOMMAND .

Tutte le voci di menu della finestra predefinite hanno numeri di identificatore maggiori di 0xF000. Se un'applicazione aggiunge comandi al menu della finestra, deve usare numeri di identificatore inferiori a 0xF000.

Il sistema grigia automaticamente gli elementi nel menu della finestra standard, a seconda della situazione. L'applicazione può eseguire il proprio controllo o grigio rispondendo al messaggio di WM_INITMENU inviato prima che venga visualizzato qualsiasi menu.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-menu-l1-1-0 (introdotto in Windows 8)