Funzione DeleteMenu (winuser.h)

Articolo
08/27/2023

Elimina un elemento dal menu specificato. Se la voce di menu apre un menu o un sottomenu, questa funzione elimina definitivamente l'handle nel menu o nel sottomenu e libera la memoria utilizzata dal menu o dal sottomenu.

Sintassi

BOOL DeleteMenu(
  [in] HMENU hMenu,
  [in] UINT  uPosition,
  [in] UINT  uFlags
);

Parametri

[in] hMenu

Tipo: HMENU

Handle del menu da modificare.

[in] uPosition

Tipo: UINT

Voce di menu da eliminare, come determinato dal parametro uFlags .

[in] uFlags

Tipo: UINT

Indica come viene interpretato il parametro uPosition . Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
MF_BYCOMMAND 0x0000000L	Indica che uPosition fornisce l'identificatore della voce di menu. Il flag MF_BYCOMMAND è il flag predefinito se non viene specificato né il flag MF_BYCOMMANDné MF_BYPOSITION .
MF_BYPOSITION 0x0000400L	Indica che uPosition assegna la posizione relativa in base zero della voce di menu.

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

L'applicazione deve chiamare la funzione DrawMenuBar ogni volta che viene modificato un menu, indipendentemente dal fatto che il menu si trova in una finestra visualizzata.

Esempio

Per un esempio, vedere Esempio di visualizzatore Appunti.

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)

Vedi anche

Informazioni concettuali

DrawMenuBar

Riferimento

RemoveMenu