ImmGetImeMenuItemsA, fonction (imm.h)

Article
11/20/2024

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 des 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 associés à la configuration IME.
IGIMII_TOOLS	Récupérez les éléments de menu associés aux outils IME.
IGIMII_HELP	Récupérez les éléments de menu qui contrôlent l’aide 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 sous-éléments 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 IMEMENUITEMINFO structures dans lesquelles la fonction récupère des informations sur les éléments de menu. Ce paramètre contient 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 de retour

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é.

Remarques

Note

L’en-tête imm.h définit ImmGetImeMenuItems 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 XP [applications de bureau uniquement], prise en charge linguistique de l’Asie de l’Est installée.
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	imm.h (include Immdev.h, Windows.h)
bibliothèque	Imm32.lib
DLL	Imm32.dll

Voir aussi

IMEMENUITEMINFO

du gestionnaire de méthodes d’entrée

fonctions Input Method Manager

Partager via