GetMenuState

La funzione GetMenuState recupera le bandiere dal menu associate alla voce di menu specificata. Se la voce di menu si apre un sottomenu, anche questa funzione restituisce il numero di elementi nel sottomenu.

La funzione GetMenuState è stata sostituita dalla funzione GetMenuItemInfo . È comunque possibile utilizzare GetMenuState, tuttavia, se non è necessario le funzionalità estese di GetMenuItemInfo.

(UINT GetMenuState HMENU  hMenu, / / handle al menuUINTuId, / / la voce del menu per eseguire una query UINTuFlags / / dal menu flags);
 

Parametri

hMenu
Gestire al menu che contiene la voce di menu cui flag sono da recuperare.
uId
Specifica la voce di menu per i quali i flag di menù sono da recuperare, come determinato dal parametro uFlags.
uFlags
Specifica come viene interpretato il parametro uId . Questo parametro può essere uno dei seguenti valori:
Valore Descrizione
MF_BYCOMMAND Indica che il parametro uId dà l'identificatore della voce di menu. La bandiera MF_BYCOMMAND è il valore predefinito se viene specificato il flag MF_BYCOMMAND né MF_BYPOSITION.
MF_BYPOSITION Indica che il parametro uId dà la posizione relativa in base zero della voce di menu.

Valori restituiti

Se l'elemento specificato non esiste, il valore restituito è 0xFFFFFFFF.

Se la voce di menu si apre un sottomenu, il byte di ordine inferiore del valore restituito contiene le bandiere dal menu associate all'elemento e il byte di ordine superiore contiene il numero di elementi nel sottomenu aperto dall'elemento.

In caso contrario, il valore restituito è una maschera (Boolean O) delle bandiere dal menu. Di seguito sono riportati i flag di menù associati la voce di menu.

Valore Descrizione
MF_CHECKED Inserisce un segno di spunta accanto all'elemento (per il menu a discesa, i sottomenu e menu di scelta rapida solo).
MF_DISABLED Disabilita l'elemento.
MF_GRAYED Disattiva e l'elemento di Verolanuova.
MF_HILITE Mette in evidenza l'elemento.
MF_MENUBARBREAK Funzioni lo stesso come il MF_MENUBREAK bandiera, fatta eccezione per il menu a discesa, i sottomenu e menu di scelta rapida, dove la nuova colonna è separata dalla vecchia colonna da una linea verticale.
MF_MENUBREAK Pone la voce su una nuova linea (per le barre dei menu) o in una nuova colonna (per il menu a discesa, i sottomenu e menu di scelta rapida) senza separare colonne.
MF_SEPARATOR Crea una linea di demarcazione orizzontale (per il menu a discesa, i sottomenu e menu di scelta rapida solo).

Vedi anche

Panoramica di menu, Menu funzioni, GetMenu, GetMenuItemCount, GetMenuItemID, GetMenuItemInfo

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index