ImmNotifyIME, fonction (imm.h)

Avertit l’IME des modifications apportées au status du contexte d’entrée.

Syntaxe

BOOL ImmNotifyIME(
       HIMC  unnamedParam1,
  [in] DWORD dwAction,
  [in] DWORD dwIndex,
  [in] DWORD dwValue
);

Paramètres

unnamedParam1

[in] dwAction

Code de la notification. Ce paramètre peut avoir l’une des valeurs suivantes.

Valeur Signification
NI_CHANGECANDIDATELIST
Une application a modifié le candidat sélectionné actuel. Le paramètre dwIndex spécifie un index d’une liste candidate à sélectionner et dwValue n’est pas utilisé.
NI_CLOSECANDIDATE
Une application indique à l’IME de fermer une liste de candidats. Le paramètre dwIndex spécifie un index de la liste à fermer, et dwValue n’est pas utilisé. L’IME envoie une commande IMN_CLOSECANDIDATE à l’application si elle ferme la liste.
NI_COMPOSITIONSTR
Une application indique à l’IME d’effectuer une action sur la chaîne de composition. Le paramètre dwIndex peut être CPS_CANCEL, CPS_COMPLETE, CPS_CONVERT ou CPS_REVERT.
NI_IMEMENUSELECTED
Une application indique à l’IME d’autoriser l’application à gérer le menu spécifié. Le paramètre dwIndex spécifie l’ID du menu et dwValue est une valeur définie par l’application pour cet élément de menu.
NI_OPENCANDIDATE
Une application indique à l’IME d’ouvrir une liste de candidats. Le paramètre dwIndex spécifie l’index de la liste à ouvrir, et dwValue n’est pas utilisé. L’IME envoie une commande IMN_OPENCANDIDATE à l’application si elle ouvre la liste.
NI_SELECTCANDIDATESTR
Une candidature a sélectionné l’un des candidats. Le paramètre dwIndex spécifie un index d’une liste candidate à sélectionner. Le paramètre dwValue spécifie un index d’une chaîne candidate dans la liste des candidats sélectionnés.
NI_SETCANDIDATE_PAGESIZE
L’application modifie la taille de page d’une liste de candidats. Le paramètre dwIndex spécifie la liste candidate à modifier et doit avoir une valeur comprise entre 0 et 3. Le paramètre dwValue spécifie la nouvelle taille de page.
NI_SETCANDIDATE_PAGESTART
L’application modifie l’index de démarrage de page d’une liste de candidats. Le paramètre dwIndex spécifie la liste candidate à modifier et doit avoir une valeur comprise entre 0 et 3. Le paramètre dwValue spécifie le nouvel index de démarrage de page.

[in] dwIndex

Index d’une liste candidate. Si dwAction est NI_COMPOSITIONSTR, ce paramètre peut également avoir l’une des valeurs suivantes.

Valeur Signification
CPS_CANCEL
Effacez la chaîne de composition et définissez la status sur aucune chaîne de composition.
CPS_COMPLETE
Définissez la chaîne de composition comme chaîne de résultat.
CPS_CONVERT
Convertissez la chaîne de composition.
CPS_REVERT
Annulez la chaîne de composition actuelle et définissez la chaîne de composition sur la chaîne non convertie.

[in] dwValue

Index d’une chaîne candidate. L’application peut définir ce paramètre ou l’ignorer, en fonction de la valeur du paramètre dwAction .

Valeur retournée

Retourne une valeur différente de zéro en cas de réussite, ou 0 dans le cas contraire.

Configuration requise

   
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

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

Gestionnaire de méthodes d’entrée

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