Funzione DestroyMenu (winuser.h)

Articolo
08/27/2023

Elimina definitivamente il menu specificato e libera qualsiasi memoria occupata dal menu.

Sintassi

BOOL DestroyMenu(
  [in] HMENU hMenu
);

Parametri

[in] hMenu

Tipo: HMENU

Handle del menu da eliminare definitivamente.

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

Prima di chiudere, un'applicazione deve usare la funzione DestroyMenu per eliminare definitivamente un menu non assegnato a una finestra. Un menu assegnato a una finestra viene eliminato automaticamente alla chiusura dell'applicazione.

DestroyMenu è ricorsivo, ovvero distruggerà il menu e tutti i suoi sottomenu.

Esempio

Per un esempio, vedere Visualizzazione di un menu di scelta rapida.

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)