Funzione GetMenuDefaultItem (winuser.h)

  • Articolo

Determina la voce di menu predefinita nel menu specificato.

Sintassi

UINT GetMenuDefaultItem(
  [in] HMENU hMenu,
  [in] UINT  fByPos,
  [in] UINT  gmdiFlags
);

Parametri

[in] hMenu

Tipo: HMENU

Handle al menu per cui recuperare la voce di menu predefinita.

[in] fByPos

Tipo: UINT

Indica se recuperare l'identificatore della voce di menu o la relativa posizione. Se questo parametro è FALSE, viene restituito l'identificatore. In caso contrario, la posizione viene restituita.

[in] gmdiFlags

Tipo: UINT

Indica come la funzione deve cercare le voci di menu. Questo parametro può essere zero o più dei valori seguenti.

Valore Significato
GMDI_GOINTOPOPUPS
0x0002L
 Se l'elemento predefinito è uno che apre un sottomenu, la funzione consiste nel cercare in modo ricorsivo nel sottomenu corrispondente. Se il sottomenu non ha alcun elemento predefinito, il valore restituito identifica l'elemento che apre il sottomenu. Per impostazione predefinita, la funzione restituisce il primo elemento predefinito nel menu specificato, indipendentemente dal fatto che si tratti di un elemento che apre un sottomenu.
GMDI_USEDISABLED
0x0001L
 La funzione consiste nel restituire un elemento predefinito, anche se è disabilitato. Per impostazione predefinita, la funzione ignora elementi disabilitati o grigi.

Valore restituito

Tipo: UINT

Se la funzione ha esito positivo, il valore restituito è l'identificatore o la posizione della voce di menu.

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

Requisiti

Requisito Valore
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

Menu

Riferimento

SetMenuDefaultItem