Méthode ITfReverseConversionMgr ::GetReverseConversion (msctf.h)

Article
08/24/2023

[GetReverseConversion est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Pour un usage interne uniquement.]

Récupère un objet ITfReverseConversion qui peut effectuer des conversions inversées.

Syntaxe

HRESULT GetReverseConversion(
  [in]  LANGID               langid,
  [in]  REFGUID              guidProfile,
  [in]  DWORD                dwflag,
  [out] ITfReverseConversion **ppReverseConversion
);

Paramètres

[in] langid

ID de langue du profil auquel appartiennent les chaînes cibles.

[in] guidProfile

GUID du profil auquel appartiennent les chaînes cibles.

[in] dwflag

Valeur	Signification
TF_RCM_COMLESS 0x00000001	Activez l’interface de conversion inverse sans COM.
TF_RCM_VKEY 0x00000002	La sortie doit être un tableau de codes de clé virtuelle (au lieu de codes de clé de caractère).
TF_RCM_HINT_READING_LENGTH 0x00000004	La conversion inverse doit hiérarchiser l’ordre des entrées dans la liste de sortie en fonction de la longueur de la séquence d’entrée, en premier lieu les séquences les plus courtes. Il est possible qu’une séquence d’entrée avec un faible nombre de collisions soit beaucoup plus élevée qu’une séquence d’entrée avec un nombre de collisions similaire (mais légèrement plus élevé). L’interprétation de cet indicateur varie en fonction de l’IME.
TF_RCM_HINT_COLLISION 0x00000008	La conversion inverse doit hiérarchiser l’ordre des entrées dans la liste de sorties en fonction du nombre de collisions, les entrées contenant d’abord le plus petit nombre de collisions. Si une séquence d’entrée correspond à beaucoup plus de caractères qu’une séquence d’entrée légèrement plus longue, il peut être préférable d’utiliser la séquence d’entrée plus longue à la place. L’IME détermine si cet indicateur affecte la sortie de conversion inverse.

[out] ppReverseConversion

Pointeur vers l’adresse de l’objet ITfReverseConversion qui peut effectuer la conversion inverse spécifiée.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur retournée	Description
S_OK	Un ITfReverseConversion pour la combinaison langid et guidProfile spécifiée est disponible.
E_NOTIMPL	La combinaison langid et guidProfile spécifiée ne prend pas en charge la conversion inverse.
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Une conversion inverse fournit les séquences de frappe nécessaires pour créer la chaîne spécifiée.

Lorsque ni l’indicateur TF_RCM_HINT_COLLISION ni TF_RCM_HINT_READING_LENGTH n’est spécifié pour dwflag, l’IME peut ne pas organiser la sortie dans n’importe quel ordre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll

Voir aussi

ITfReverseConversionMgr

Partager via