GetMenuItemInfoA, fonction (winuser.h)

Article
11/20/2024

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 pour obtenir des informations sur. La signification de ce paramètre dépend de la valeur de fByPosition.

[in] fByPosition

Type : BOOL

Signification de uItem. Si ce paramètre est 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 de retour

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 GetMenuItemInfo une fois de plus 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 membrefTypefType et définit cch sur 0.

Exemples

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

Note

L’en-tête winuser.h définit GetMenuItemInfo comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include 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

conceptuelle

menus

de référence

SetMenuItemInfo

Partager via