Funzione DeleteMenu (winuser.h)

  • Articolo

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

Menu

Riferimento

RemoveMenu