Share via

Função SendIMEMessageExW (ime.h)

  • Artigo

[Essa função está 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 SendIMEMessageExW(
       HWND   unnamedParam1,
       LPARAM unnamedParam2
);

Parâmetros

unnamedParam1

unnamedParam2

Valor retornado

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 é aninhada e, portanto, não pode ser usada.
IME_RS_NOIME
 O IME não foi selecionado (não foi instalado).
IME_RS_NOROOM
 Falta 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.

Comentários

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 membro wParam 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.

Observação

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 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 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ime.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll