ImmGetProperty, fonction (immdev.h)
Récupère la propriété et les fonctionnalités de l’IME associé 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 valeur de la propriété ou de la fonctionnalité, en fonction de la valeur du paramètre dwIndex . Si dwIndex est défini sur 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 d’insertion. Si elle est claire, la fenêtre est proche de la position d’insertion. |
| 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 des candidats sont numérotées à partir de 1. Si la valeur est claire, les chaînes commencent à 0. |
| IME_PROP_UNICODE | S’il est défini, l’IME est vu comme un IME Unicode. Le système d’exploitation et l’IME communiquent via l’interface Unicode IME. 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é. Si cette option est désactivée, 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’Élément Unicode injecté provenant de la fonction SendInput à l’aide de VK_PACKET. S’il est clair, l’IME risque de ne pas traiter l’Élément Unicode injecté et d’envoyer directement l’élément Unicode injecté à l’application. |
Si dwIndex est défini sur IGP_UI, la fonction retourne une ou plusieurs des valeurs suivantes :
| Valeur | Signification |
|---|---|
| UI_CAP_2700 | Prise en charge des valeurs d’échappement de texte de 0 ou 2700. Pour plus d’informations, consultez le membre lfEscapement de la structure LOGFONT . |
| UI_CAP_ROT90 | Prise en charge des 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 est défini sur 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 conversion. Utilisez ImmSetCompositionString pour effectuer une conversion. |
Si dwIndex est défini sur IGP_SELECT, la fonction retourne une ou plusieurs des valeurs suivantes :
| Valeur | Signification |
|---|---|
| SELECT_CAP_CONVMODE | Héritez du mode de conversion lorsqu’un nouvel IME est sélectionné. |
| SELECT_CAP_SENTENCE | Héritez du mode phrase lorsqu’un nouvel IME est sélectionné. |
Si dwIndex est défini sur 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. |
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 | immdev.h (inclure Immdev.h, Windows.h) |
| Bibliothèque | Imm32.lib |
| DLL | Imm32.dll |