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 |