Partilhar via

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

[GetReverseConversion está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Somente para uso interno.]

Recupera um objeto ITfReverseConversion que pode executar conversões inversas.

Sintaxe

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

Parâmetros

[in] langid

A ID do idioma do perfil ao qual as cadeias de caracteres de destino pertencem.

[in] guidProfile

O GUID do perfil ao qual pertencem as cadeias de caracteres de destino.

[in] dwflag

Valor Significado
TF_RCM_COMLESS
0x00000001
 Ative a interface de conversão inversa sem COM.
TF_RCM_VKEY
0x00000002
 A saída deve ser uma matriz de códigos de chave virtual (em vez de códigos de chave de caractere).
TF_RCM_HINT_READING_LENGTH
0x00000004
 A conversão inversa deve priorizar a ordem das entradas na lista de saída com base no comprimento da sequência de entrada, com as sequências mais curtas primeiro. É possível que uma sequência de entrada com uma contagem de colisão baixa seja muito maior do que uma sequência de entrada com uma contagem de colisão semelhante (mas ligeiramente maior). A interpretação desse sinalizador varia dependendo do IME.
TF_RCM_HINT_COLLISION
0x00000008
 A conversão inversa deve priorizar a ordem das entradas na lista de saída com base na contagem de colisões, com as entradas contendo o menor número de colisões primeiro. Se uma sequência de entrada corresponder a muito mais caracteres do que uma sequência de entrada um pouco mais longa, talvez seja preferível usar a sequência de entrada mais longa. O IME determina se esse sinalizador afetará a saída de conversão inversa.

[out] ppReverseConversion

Um ponteiro para o endereço do objeto ITfReverseConversion que pode executar a conversão inversa especificada.

Retornar valor

Esse método pode retornar um desses valores.

Valor retornado Descrição
S_OK
 Um ITfReverseConversion para a combinação de langid e guidProfile especificada está disponível.
E_NOTIMPL
 A combinação de langid e guidProfile especificada não dá suporte à conversão inversa.
E_FAIL
 Ocorreu um erro não especificado.

Comentários

Uma conversão inversa fornece as sequências de pressionamento de tecla necessárias para criar a cadeia de caracteres especificada.

Quando nem o sinalizador TF_RCM_HINT_COLLISION ou TF_RCM_HINT_READING_LENGTH for especificado para dwflag, o IME poderá não organizar a saída em nenhum tipo de ordem.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho msctf.h
DLL Msctf.dll

Confira também

ITfReverseConversionMgr

  • Last updated on