Função ImmGetConversionListA (immdev.h)

  • Artigo

Recupera a lista de resultados de conversão de caracteres ou palavras sem gerar mensagens relacionadas ao IME.

Sintaxe

DWORD ImmGetConversionListA(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCSTR          lpSrc,
  [out] LPCANDIDATELIST lpDst,
  [in]  DWORD           dwBufLen,
  [in]  UINT            uFlag
);

Parâmetros

unnamedParam1

unnamedParam2

[in] lpSrc

Ponteiro para uma cadeia de caracteres terminada em nulo especificando a origem da lista.

[out] lpDst

Ponteiro para uma estrutura CANDIDATELIST na qual a função recupera a lista.

[in] dwBufLen

Tamanho, em bytes, do buffer de saída. O aplicativo define esse parâmetro como 0 se a função deve retornar o tamanho do buffer necessário para a lista de resultados de conversão completa.

[in] uFlag

Sinalizador de ação. Esse parâmetro pode ter um dos valores a seguir.

Valor Significado
GCL_CONVERSION
 Cadeia de caracteres de origem é a cadeia de caracteres de leitura. A função copia a cadeia de caracteres de resultado para o buffer de destino.
GCL_REVERSECONVERSION
 Cadeia de caracteres de origem é a cadeia de caracteres de resultado. A função copia a cadeia de caracteres de leitura para o buffer de destino.
GCL_REVERSE_LENGTH
 Cadeia de caracteres de origem é a cadeia de caracteres de resultado. A função retorna o tamanho, em bytes, da cadeia de caracteres de leitura criada se GCL_REVERSECONVERSION for especificado.

Retornar valor

Retorna o número de bytes copiados para o buffer de saída. Se o aplicativo definir o parâmetro dwBufLen como 0, a função retornará o tamanho, em bytes, do buffer de saída necessário.

Comentários

Observação

O cabeçalho immdev.h define ImmGetConversionList como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho], suporte ao idioma do Leste Asiático instalado.
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho immdev.h (inclua Immdev.h, Windows.h)
Biblioteca Imm32.lib
DLL Imm32.dll

Confira também

CANDIDATELIST

Gerenciador de Métodos de Entrada

Funções do Gerenciador de Métodos de Entrada