Função SendIMEMessageExA (ime.h)

Artigo
11/20/2024

[Essa função é obsoleta e não deve ser usada.]

Especifica uma ação ou processamento para o IME (Editor de Método de Entrada) por meio de uma subfunção especificada.

Sintaxe

LRESULT SendIMEMessageExA(
       HWND   unnamedParam1,
       LPARAM unnamedParam2
);

Parâmetros

unnamedParam1

unnamedParam2

Valor de retorno

O resultado do processamento da subfunção. Se o resultado não for bem-sucedido, um dos seguintes códigos de erro será armazenado no wParam da estrutura IMESTRUCT .

Código de retorno	Descrição
IME_RS_DISKERROR	Erro de disco.
IME_RS_ERROR	Erro geral.
IME_RS_ILLEGAL	Contém um caractere ilegal.
IME_RS_INVALID	Subfunção inválida.
IME_RS_NEST	A subfunção está aninhada e, portanto, não pode ser usada.
IME_RS_NOIME	O IME não foi selecionado (não foi instalado).
IME_RS_NOROOM	Abreviação de área.
IME_RS_NOTFOUND	Nenhum candidato foi encontrado.
IME_RS_SYSTEMMODAL	O Windows está no modo do sistema, os dados não podem ser passados para o IME.
IME_RS_TOOLONG	Caracteres muito longos.

Observações

SendIMEMessageEx garante a ação estipulada nas especificações somente para IMEs que dão suporte à mensagem WM_CONVERTREQUESTEX. Para um IME que não dá suporte a WM_CONVERTREQUESTEX, SendIMEMessageEx envia uma mensagem WM_CONVERTREQUEST para o IME e retorna o conteúdo do wParam membro da estrutura IMESTRUCT . Se o processamento da subfunção não tiver sido concluído normalmente, essas funções definirão IME_RS_ERROR em wParam.

Nota

O cabeçalho ime.h define SendIMEMessageEx 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 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ime.h (incluir Windows.h)
biblioteca	User32.lib
de DLL	User32.dll

Compartilhar via