GetMenuItemInfoA, fonction (winuser.h)

Article
08/27/2023

Récupère des informations sur un élément de menu.

Syntaxe

BOOL GetMenuItemInfoA(
  [in]      HMENU           hmenu,
  [in]      UINT            item,
  [in]      BOOL            fByPosition,
  [in, out] LPMENUITEMINFOA lpmii
);

Paramètres

[in] hmenu

Type : HMENU

Handle du menu qui contient l’élément de menu.

[in] item

Type : UINT

Identificateur ou position de l’élément de menu sur lequel obtenir des informations. La signification de ce paramètre dépend de la valeur de fByPosition.

[in] fByPosition

Type : BOOL

Signification de uItem. Si ce paramètre a la valeur FALSE, uItem est un identificateur d’élément de menu. Sinon, il s’agit d’une position d’élément de menu. Pour plus d’informations, consultez Accès aux éléments de menu par programmation .

[in, out] lpmii

Type : LPMENUITEMINFO

Pointeur vers une structure MENUITEMINFO qui spécifie les informations à récupérer et reçoit des informations sur l’élément de menu. Notez que vous devez définir le membre cbSize sur sizeof(MENUITEMINFO) avant d’appeler cette fonction.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .

Remarques

Pour récupérer un élément de menu de type MFT_STRING, recherchez d’abord la taille de la chaîne en définissant le membre dwTypeData de MENUITEMINFO sur NULL , puis en appelant GetMenuItemInfo. La valeur de cch+1 correspond à la taille nécessaire. Ensuite, allouez une mémoire tampon de cette taille, placez le pointeur vers la mémoire tampon dans dwTypeData, incrémentez cch par un, puis appelez à nouveau GetMenuItemInfo pour remplir la mémoire tampon avec la chaîne.

Si l’élément de menu récupéré est d’un autre type, GetMenuItemInfo définit le membre dwTypeData sur une valeur dont le type est spécifié par le membre fType fTypeet définit cch sur 0.

Exemples

Pour obtenir un exemple, consultez Exemple d’éléments de menu Owner-Drawn.

Notes

L’en-tête winuser.h définit GetMenuItemInfo comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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-3 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

Conceptuel

Menus

Référence

SetMenuItemInfo

Partager via