STRUCTURE IMEMENUITEMINFOA (imm.h)

Article
11/20/2024

Contient des informations sur les éléments de menu IME.

Syntaxe

typedef struct tagIMEMENUITEMINFOA {
  UINT    cbSize;
  UINT    fType;
  UINT    fState;
  UINT    wID;
  HBITMAP hbmpChecked;
  HBITMAP hbmpUnchecked;
  DWORD   dwItemData;
  CHAR    szString[IMEMENUITEM_STRING_SIZE];
  HBITMAP hbmpItem;
} IMEMENUITEMINFOA, *PIMEMENUITEMINFOA, *NPIMEMENUITEMINFOA, *LPIMEMENUITEMINFOA;

Membres

cbSize

Taille, en octets, de la structure.

fType

Type d’élément de menu. Ce membre peut avoir l’une des valeurs suivantes.

Valeur	Signification
IMFT_RADIOCCHECK	Afficher les éléments de menu activés à l’aide d’une case d’option au lieu d’une coche si le membre hbmpChecked est NULL.
IMFT_SEPARATOR	L’élément de menu est un séparateur. Un séparateur d’élément de menu apparaît sous la forme d’une ligne de division horizontale. Les membres hbmpItem et szString sont ignorés dans ce cas.
IMFT_SUBMENU	L’élément de menu est un sous-menu.

fState

État de l’élément de menu. Ce membre peut avoir une ou plusieurs des valeurs suivantes :

Valeur	Signification
IMFS_CHECKED	L’élément de menu est activé. Pour plus d’informations, consultez la description du membre hbmpChecked.
IMFS_DEFAULT	L’élément de menu est la valeur par défaut. Un menu ne peut contenir qu’un seul élément de menu par défaut, qui est affiché en gras.
IMFS_DISABLED	L’élément de menu est désactivé et apparaît grisé afin qu’il ne puisse pas être sélectionné. Cela équivaut à IMFS_GRAYED.
IMFS_ENABLED	L’élément de menu est activé. Il s’agit de l’état par défaut.
IMFS_GRAYED	L’élément de menu est désactivé et apparaît grisé afin qu’il ne puisse pas être sélectionné. Cela équivaut à IMFS_DISABLED.
IMFS_HILITE	L’élément de menu est mis en surbrillance.
IMFS_UNCHECKED	L’élément de menu est désactivé. Pour plus d’informations sur les éléments de menu non activés, consultez la description du membre hbmpUnchecked.
IMFS_UNHILITE	L’élément de menu n’est pas mis en surbrillance. Il s’agit de l’état par défaut.

wID

Valeur 16 bits définie par l’application qui identifie l’élément de menu.

hbmpChecked

Gérez l’image bitmap pour qu’elle s’affiche en regard de l’élément si elle est cochée. Si ce membre est NULL, une bitmap par défaut est utilisée. Si la valeur de type IMFT_RADIOCHECK est spécifiée, la bitmap par défaut est une puce. Sinon, il s’agit d’une coche.

hbmpUnchecked

Gérez la bitmap pour qu’elle s’affiche en regard de l’élément si elle n’est pas cochée. Si ce membre est null, aucune bitmap n’est utilisée.

dwItemData

Valeur définie par l’application associée à l’élément de menu.

szString[IMEMENUITEM_STRING_SIZE]

Contenu de l’élément de menu. Il s’agit d’une chaîne terminée par null.

hbmpItem

Gérer vers une bitmap à afficher.

Remarques

Note

L’en-tête imm.h définit IMEMENUITEMINFO 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]
d’en-tête	imm.h (include Immdev.h, Windows.h)

Voir aussi

ImmGetImeMenuItems

du gestionnaire de méthodes d’entrée

structures Input Method Manager

Partager via