Fonction ImmGetProperty (imm.h)

Récupère la propriété et les fonctionnalités de l’IME associées aux paramètres régionaux d’entrée spécifiés.

Syntaxe

DWORD ImmGetProperty(
       HKL   unnamedParam1,
       DWORD unnamedParam2
);

Paramètres

unnamedParam1

unnamedParam2

Valeur retournée

Retourne la propriété ou la valeur de capacité, en fonction de la valeur du paramètre dwIndex . Si dwIndex a la valeur IGP_PROPERTY, la fonction retourne une ou plusieurs des valeurs suivantes :

Valeur	Signification
IME_PROP_AT_CARET	Si elle est définie, la fenêtre de conversion se trouve à la position du caret. S’il est clair, la fenêtre se trouve près de la position du caret.
IME_PROP_SPECIAL_UI	S’il est défini, l’IME a une interface utilisateur non standard. L’application ne doit pas dessiner dans la fenêtre IME.
IME_PROP_CANDLIST_START_FROM_1	Si la valeur est définie, les chaînes de la liste candidate sont numérotées à partir de 1. Si la valeur est désactivée, les chaînes commencent à 0.
IME_PROP_UNICODE	S’il est défini, l’IME est vu en tant qu’IME Unicode. Le système d’exploitation et l’IME communiquent via l’interface IME Unicode. S’il est clair, l’IME utilise l’interface ANSI pour communiquer avec le système d’exploitation.
IME_PROP_COMPLETE_ON_UNSELECT	S’il est défini, l’IME termine la chaîne de composition lorsque l’IME est désactivé. S’il est désactivé, l’IME annule la chaîne de composition lorsque l’IME est désactivé, par exemple à partir d’une modification de disposition du clavier.
IME_PROP_ACCEPT_WIDE_VKEY	S’il est défini, l’IME traite l’Unicode injecté provenant de la fonction SendInput à l’aide de VK_PACKET. S’il est clair, l’IME risque de ne pas traiter l’Unicode injecté et d’envoyer directement l’Unicode injecté à l’application.

 

Si dwIndex a la valeur IGP_UI, la fonction retourne une ou plusieurs des valeurs suivantes :

Valeur	Signification
UI_CAP_2700	Prend en charge les valeurs d’échappement de texte de 0 ou 2700. Pour plus d’informations, consultez le membre lfEscapement de la structure LOGFONT .
UI_CAP_ROT90	Prend en charge les valeurs d’échappement de texte de 0, 900, 1800 ou 2700. Pour plus d’informations, consultez lfEscapement.
UI_CAP_ROTANY	Prend en charge toute valeur d’échappement de texte. Pour plus d’informations, consultez lfEscapement.

 

Si dwIndex a la valeur IGP_SETCOMPSTR, la fonction retourne une ou plusieurs des valeurs suivantes :

Valeur	Signification
SCS_CAP_COMPSTR	Créez la chaîne de composition en appelant la fonction ImmSetCompositionString avec la valeur SCS_SETSTR.
SCS_CAP_MAKEREAD	Créez la chaîne de lecture à partir de la chaîne de composition correspondante lors de l’utilisation de la fonction ImmSetCompositionString avec SCS_SETSTR et sans définir lpRead.
SCS_CAP_SETRECONVERTSTRING :	Cet IME peut prendre en charge la reconversion. Utilisez ImmSetCompositionString pour effectuer une reconversion.

 

Si dwIndex a la valeur IGP_SELECT, la fonction retourne une ou plusieurs des valeurs suivantes :

Valeur	Signification
SELECT_CAP_CONVMODE	Hériter du mode de conversion lorsqu’un nouvel IME est sélectionné.
SELECT_CAP_SENTENCE	Hériter du mode phrase lorsqu’un nouvel IME est sélectionné.

 

Si dwIndex a la valeur IGP_GETIMEVERSION, la fonction retourne une ou plusieurs des valeurs suivantes :

Valeur	Signification
IMEVER_0310	L’IME a été créé pour Windows 3.1.
IMEVER_0400	L’IME a été créé pour Windows Me/98/95.

Configuration requise

Condition requise	Valeur
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

ImmSetCompositionString

Gestionnaire de méthodes d’entrée

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