Compartir a través de

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

  • Artículo

[GetReverseConversion está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. Solo para uso interno.]

Recupera un objeto ITfReverseConversion que puede realizar conversiones inversas.

Sintaxis

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

Parámetros

[in] langid

Identificador de idioma del perfil al que pertenecen las cadenas de destino.

[in] guidProfile

GUID del perfil al que pertenecen las cadenas de destino.

[in] dwflag

Valor Significado
TF_RCM_COMLESS
0x00000001
 Active la interfaz de conversión inversa sin COM.
TF_RCM_VKEY
0x00000002
 La salida debe ser una matriz de códigos de clave virtual (en lugar de códigos de clave de caracteres).
TF_RCM_HINT_READING_LENGTH
0x00000004
 La conversión inversa debe priorizar el orden de las entradas de la lista de salida en función de la longitud de la secuencia de entrada, con las secuencias más cortas primero. Es posible que una secuencia de entrada con un recuento de colisiones bajo sea mucho mayor que una secuencia de entrada con un recuento de colisiones similar (pero ligeramente superior). La interpretación de esta marca varía según el IME.
TF_RCM_HINT_COLLISION
0x00000008
 La conversión inversa debe priorizar el orden de las entradas de la lista de salida en función del recuento de colisiones, con las entradas que contienen primero el número más bajo de colisiones. Si una secuencia de entrada corresponde a muchos más caracteres que una secuencia de entrada ligeramente más larga, podría ser preferible usar la secuencia de entrada más larga en su lugar. El IME determina si esta marca afectará a la salida de conversión inversa.

[out] ppReverseConversion

Puntero a la dirección del objeto ITfReverseConversion que puede realizar la conversión inversa especificada.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor devuelto Descripción
S_OK
 Hay disponible una ITfReverseConversion para la combinación de langid y guidProfile especificada.
E_NOTIMPL
 La combinación de langid y guidProfile especificada no admite la conversión inversa.
E_FAIL
 Se ha producido un error no especificado.

Comentarios

Una conversión inversa proporciona las secuencias de pulsación de teclas necesarias para crear la cadena especificada.

Cuando no se especifica la marca TF_RCM_HINT_COLLISION o TF_RCM_HINT_READING_LENGTH para dwflag, es posible que el IME no organice la salida en ningún tipo de orden.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado msctf.h
Archivo DLL Msctf.dll

Consulte también

ITfReverseConversionMgr