Funzione SetMenu (winuser.h)

Articolo
03/04/2024

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

Riferimento

Share via