Funzione CreatePopupMenu (winuser.h)

Articolo
08/27/2023

Crea un menu a discesa, un sottomenu o un menu di scelta rapida. Il menu è inizialmente vuoto. È possibile inserire o aggiungere voci di menu usando la funzione InsertMenuItem . È anche possibile utilizzare la funzione InsertMenu per inserire voci di menu e la funzione AppendMenu per aggiungere voci di menu.

Sintassi

HMENU CreatePopupMenu();

Valore restituito

Tipo: HMENU

Se la funzione ha esito positivo, il valore restituito è un handle per il menu appena creato.

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

Commenti

L'applicazione può aggiungere il nuovo menu a un menu esistente oppure può visualizzare un menu di scelta rapida chiamando le funzioni TrackPopupMenuEx o TrackPopupMenu .

Le risorse associate a un menu assegnato a una finestra vengono liberate automaticamente. Se il menu non è assegnato a una finestra, un'applicazione deve liberare le risorse di sistema associate al menu prima di chiudere. Un'applicazione libera le risorse di menu chiamando la funzione DestroyMenu .

Esempio

Per un esempio, vedere Aggiunta di linee e grafici a un menu.

Requisiti


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)