Metodo ITfReverseConversionMgr::GetReverseConversion (msctf.h)

Articolo
02/29/2024

[GetReverseConversion è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Solo per l'uso interno.

Recupera un oggetto ITfReverseConversion che può eseguire conversioni inversa.

Sintassi

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

Parametri

[in] langid

ID lingua del profilo a cui appartengono le stringhe di destinazione.

[in] guidProfile

GUID del profilo a cui appartengono le stringhe di destinazione.

[in] dwflag

Valore	Significato
TF_RCM_COMLESS 0x00000001	Attivare l'interfaccia di conversione inversa senza COM.
TF_RCM_VKEY 0x00000002	L'output deve essere una matrice di codici chiave virtuale anziché codici chiave carattere.
TF_RCM_HINT_READING_LENGTH 0x00000004	La conversione inversa deve assegnare priorità all'ordine delle voci nell'elenco di output in base alla lunghezza della sequenza di input, con le sequenze più brevi. È possibile che una sequenza di input con un numero di collisioni basso possa essere molto superiore a una sequenza di input con un numero di collisioni simile (ma leggermente superiore). L'interpretazione di questo flag varia a seconda dell'IME.
TF_RCM_HINT_COLLISION 0x00000008	La conversione inversa deve assegnare priorità all'ordine delle voci nell'elenco di output in base al conteggio delle collisioni, con le voci contenenti prima il numero minimo di collisioni. Se una sequenza di input corrisponde a molti più caratteri di una sequenza di input leggermente più lunga, potrebbe essere preferibile usare invece la sequenza di input più lunga. L'IME determina se questo flag influisce sull'output della conversione inversa.

[out] ppReverseConversion

Puntatore all'indirizzo dell'oggetto ITfReverseConversion che può eseguire la conversione inversa specificata.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore restituito	Descrizione
S_OK	È disponibile una combinazione ITfReverseConversion per la combinazione langid e guidProfile specificata.
E_NOTIMPL	La combinazione langid e guidProfile specificata non supporta la conversione inversa.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Una conversione inversa fornisce le sequenze di sequenze di tasti necessarie per creare la stringa specificata.

Quando non viene specificato né il TF_RCM_HINT_COLLISIONo TF_RCM_HINT_READING_LENGTH flag per dwflag, l'IME potrebbe non disporre l'output in alcun tipo di ordine.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2008 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll

Vedi anche

ITfReverseConversionMgr

Condividi tramite