Partager via


GetMenuDefaultItem, fonction (winuser.h)

Détermine l’élément de menu par défaut dans le menu spécifié.

Syntaxe

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

Paramètres

[in] hMenu

Type : HMENU

Handle du menu pour lequel récupérer l’élément de menu par défaut.

[in] fByPos

Type : UINT

Indique s’il faut récupérer l’identificateur de l’élément de menu ou sa position. Si ce paramètre a la valeur FALSE, l’identificateur est retourné. Sinon, la position est retournée.

[in] gmdiFlags

Type : UINT

Indique comment la fonction doit rechercher des éléments de menu. Ce paramètre peut être égal à zéro ou plusieurs des valeurs suivantes.

Valeur Signification
GMDI_GOINTOPOPUPS
0x0002L
Si l’élément par défaut est celui qui ouvre un sous-menu, la fonction consiste à effectuer une recherche récursive dans le sous-menu correspondant. Si le sous-menu n’a pas d’élément par défaut, la valeur de retour identifie l’élément qui ouvre le sous-menu. Par défaut, la fonction retourne le premier élément par défaut dans le menu spécifié, qu’il s’agisse ou non d’un élément qui ouvre un sous-menu.
GMDI_USEDISABLED
0x0001L
La fonction consiste à retourner un élément par défaut, même s’il est désactivé. Par défaut, la fonction ignore les éléments désactivés ou grisés.

Valeur retournée

Type : UINT

Si la fonction réussit, la valeur de retour est l’identificateur ou la position de l’élément de menu.

Si la fonction échoue, la valeur de retour est -1. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-menu-l1-1-0 (introduit dans Windows 8)

Voir aussi

Conceptuel

Menus

Référence

SetMenuDefaultItem