Funzione SetMenu (winuser.h)

  • Articolo

Assegna un nuovo menu alla finestra specificata.

Sintassi

BOOL SetMenu(
  [in]           HWND  hWnd,
  [in, optional] HMENU hMenu
);

Parametri

[in] hWnd

Tipo: HWND

Handle alla finestra a cui deve essere assegnato il menu.

[in, optional] hMenu

Tipo: HMENU

Handle al nuovo menu. Se questo parametro è NULL, il menu corrente della finestra viene rimosso.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La finestra viene ridisegnata per riflettere la modifica del menu. Un menu può essere assegnato a qualsiasi finestra che non è una finestra figlio.

La funzione SetMenu sostituisce il menu precedente, se presente, ma non lo elimina. Un'applicazione deve chiamare la funzione DestroyMenu per eseguire questa attività.

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-3 (introdotta in Windows 10, versione 10.0.14393)

Vedi anche

Informazioni concettuali

DestroyMenu

GetMenu

Menu

Riferimento