MENUITEMINFOA, structure (winuser.h)

Contient des informations sur un élément de menu.

Syntaxe

typedef struct tagMENUITEMINFOA {
  UINT      cbSize;
  UINT      fMask;
  UINT      fType;
  UINT      fState;
  UINT      wID;
  HMENU     hSubMenu;
  HBITMAP   hbmpChecked;
  HBITMAP   hbmpUnchecked;
  ULONG_PTR dwItemData;
  LPSTR     dwTypeData;
  UINT      cch;
  HBITMAP   hbmpItem;
} MENUITEMINFOA, *LPMENUITEMINFOA;

Membres

cbSize

Type : uiNT

Taille de la structure, en octets. L’appelant doit définir ce membre sur sizeof(MENUITEMINFO).

fMask

Type : uiNT

Indique les membres à récupérer ou définir. Ce membre peut être une ou plusieurs des valeurs suivantes.

fType

Type : uiNT

Type d’élément de menu. Ce membre peut être une ou plusieurs des valeurs suivantes.

Les valeurs MFT_BITMAP, MFT_SEPARATORet MFT_STRING ne peuvent pas être combinées entre elles. Définissez fMask sur MIIM_TYPE pour utiliser fType .

fType est utilisé uniquement si fMask a une valeur de MIIM_FTYPE.

fState

Type : uiNT

État de l’élément de menu. Ce membre peut être une ou plusieurs de ces valeurs. Définissez fMask sur MIIM_STATE pour utiliser fState.

wID

Type : uiNT

Valeur définie par l’application qui identifie l’élément de menu. Définissez fMask sur MIIM_ID pour utiliser wID .

hSubMenu

Type : HMENU

Handle du menu déroulant ou sous-menu associé à l’élément de menu. Si l’élément de menu n’est pas un élément qui ouvre un menu déroulant ou un sous-menu, ce membre est NULL. Définissez fMask sur MIIM_SUBMENU pour utiliser hSubMenu .

hbmpChecked

Type : HBITMAP

Handle vers la bitmap à afficher en regard de l’élément s’il est sélectionné. Si ce membre est NULL, une bitmap par défaut est utilisée. Si la valeur de type MFT_RADIOCHECK est spécifiée, la bitmap par défaut est une puce. Sinon, il s’agit d’une coche. Définissez fMask sur MIIM_CHECKMARKS pour utiliser hbmpChecked .

hbmpUnchecked

Type : HBITMAP

Handle vers la bitmap à afficher en regard de l’élément s’il n’est pas sélectionné. Si ce membre est null, aucune bitmap n’est utilisée. Définissez fMask sur MIIM_CHECKMARKS pour utiliser hbmpUnchecked.

dwItemData

Type : ULONG_PTR

Valeur définie par l’application associée à l’élément de menu. Définissez fMask sur MIIM_DATA pour utiliser dwItemData.

dwTypeData

Type : LPTSTR

Contenu de l’élément de menu. La signification de ce membre dépend de la valeur de fType et est utilisée uniquement si l’indicateur MIIM_TYPE est défini dans le membre fMask.

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, 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 membre fType.

Lorsque vous utilisez la fonction SetMenuItemInfo, ce membre doit contenir une valeur dont le type est spécifié par le membre fType .

dwTypeData est utilisé uniquement si l’indicateur de MIIM_STRING est défini dans le membre fMask

cch

Type : uiNT

Longueur du texte de l’élément de menu, en caractères, lorsque des informations sont reçues sur un élément de menu du type MFT_STRING. Toutefois, cch est utilisé uniquement si l’indicateur MIIM_TYPE est défini dans le membre fMask et est égal à zéro dans le cas contraire. En outre, cch est ignoré lorsque le contenu d’un élément de menu est défini en appelant SetMenuItemInfo.

Notez que, avant d’appeler GetMenuItemInfo, l’application doit définir sur la longueur de la mémoire tampon pointée par le membre dwTypeData . Si l’élément de menu récupéré est de type MFT_STRING (comme indiqué par le membre fType ), GetMenuItemInfo modifie cch à la longueur du texte de l’élément de menu. Si l’élément de menu récupéré est d’un autre type, GetMenuItemInfo définit le champ cch sur zéro.

Le membre cch est utilisé lorsque l’indicateur de MIIM_STRING est défini dans le membre fMask .

hbmpItem

Type : HBITMAP

Handle de l’image bitmap à afficher, ou il peut s’agir de l’une des valeurs du tableau suivant. Il est utilisé lorsque l’indicateur de MIIM_BITMAP est défini dans le membre fMask .

Remarques

La structure MENUITEMINFO est utilisée avec les fonctions GetMenuItemInfo, InsertMenuItemet SetMenuItemInfo.

Le menu peut afficher des éléments à l’aide de texte, de bitmaps ou des deux.

Exigences

Voir aussi

conceptuelle

GetMenuItemInfo

InsertMenuItem

menus

de référence

SetMenuItemInfo

WM_DRAWITEM

WM_MEASUREITEM