Função ImmGetConversionListA (imm.h)

Artigo
11/20/2024

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	A 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	A 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	A 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.

Valor de retorno

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.

Observações

Nota

O cabeçalho imm.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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho], suporte à linguagem do Leste Asiático instalado.
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	imm.h (inclua Immdev.h, Windows.h)
biblioteca	Imm32.lib
de DLL	Imm32.dll

Consulte também

CANDIDATELIST

do Gerenciador de Métodos de Entrada

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

Compartilhar via