ImmGetImeMenuItemsA, fonction (imm.h)

Article
08/24/2023

Récupère les éléments de menu inscrits dans le menu IME d’un contexte d’entrée spécifié.

Syntaxe

DWORD ImmGetImeMenuItemsA(
  [in]            HIMC               unnamedParam1,
  [in]            DWORD              unnamedParam2,
  [in]            DWORD              unnamedParam3,
  [out, optional] LPIMEMENUITEMINFOA lpImeParentMenu,
  [out, optional] LPIMEMENUITEMINFOA lpImeMenu,
  [in]            DWORD              dwSize
);

Paramètres

[in] unnamedParam1

Gérez le contexte d’entrée pour les éléments de menu spécifiés.

[in] unnamedParam2

Indicateur spécifiant les options d’informations de menu. La valeur suivante est définie.

Valeur	Signification
IGIMIF_RIGHTMENU	Récupérez les éléments de menu du menu contextuel, obtenus par un clic droit de la souris.

[in] unnamedParam3

Type de menu à récupérer. Ce paramètre peut avoir une ou plusieurs des valeurs suivantes.

Valeur	Signification
IGIMII_CMODE	Récupérez les éléments de menu qui contrôlent le mode de conversion.
IGIMII_SMODE	Récupérez les éléments de menu qui contrôlent le mode phrase.
IGIMII_CONFIGURE	Récupérez les éléments de menu liés à la configuration de l’IME.
IGIMII_TOOLS	Récupérez les éléments de menu liés aux outils IME.
IGIMII_HELP	Récupérez les éléments de menu qui contrôlent l’aide de l’IME.
IGIMII_OTHER	Récupérez les éléments de menu qui contrôlent d’autres fonctions IME.
IGIMII_INPUTTOOLS	Récupérez les éléments de menu qui contrôlent les éléments de menu liés aux outils d’entrée IME en fournissant un moyen étendu d’entrer des caractères.

[out, optional] lpImeParentMenu

Pointeur vers une structure IMEMENUITEMINFO dans laquelle la fonction récupère les informations de menu parent. Pour récupérer des informations sur les éléments de sous-menu de ce menu parent, l’application définit le membre fType sur MFT_SUBMENU. Ce paramètre contient NULL si la fonction récupère uniquement les éléments de menu de niveau supérieur.

[out, optional] lpImeMenu

Pointeur vers un tableau de structures IMEMENUITEMINFO dans laquelle la fonction récupère des informations sur les éléments de menu. Ce paramètre contient la valeur NULL si la fonction récupère le nombre d’éléments de menu inscrits.

[in] dwSize

Taille de la mémoire tampon pour recevoir la structure IMEMENUITEMINFO .

Valeur retournée

Retourne le nombre d’éléments de menu copiés dans lpImeMenu. Si lpImeMenu spécifie NULL, la fonction retourne le nombre d’éléments de menu inscrits dans le contexte d’entrée spécifié.

Notes

L’en-tête imm.h définit ImmGetImeMenuItems 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.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement], prise en charge des langues d’Asie de l’Est installée.
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	imm.h (inclure Immdev.h, Windows.h)
Bibliothèque	Imm32.lib
DLL	Imm32.dll

Voir aussi

IMEMENUITEMINFO

Gestionnaire de méthodes d’entrée

Fonctions du gestionnaire de méthodes d’entrée

Partager via