WM_IME_SETCONTEXT mensagem

Enviado para um aplicativo quando uma janela é ativada. Uma janela recebe essa mensagem por meio da função WindowProc.

LRESULT CALLBACK WindowProc(
  HWND  hwnd,  
  WM_IME_SETCONTEXT,  
  WPARAM wParam,      
  LPARAM lParam      
);

Parâmetros

hwnd

Um identificador para janela.

wParam

TRUE se a janela estiver ativa e FALSE caso contrário.

lParam

Opções de exibição. Esse parâmetro pode ter um ou mais dos valores a seguir.

Valor Significado
ISC_SHOWUICOMPOSITIONWINDOW
Mostrar a janela de composição pela janela de interface do usuário.
ISC_SHOWUIGUIDWINDOW
Mostrar a janela guia pela janela de interface do usuário.
ISC_SHOWUISOFTKBD
Mostrar o teclado flexível pela janela de interface do usuário.
ISC_SHOWUICANDIDATEWINDOW
Mostrar a janela candidata do índice 0 pela janela de interface do usuário.
<< ISC_SHOWUICANDIDATEWINDOW 1
Mostrar a janela candidata do índice 1 pela janela de interface do usuário.
<< ISC_SHOWUICANDIDATEWINDOW 2
Mostrar a janela candidata do índice 2 pela janela de interface do usuário.
<< ISC_SHOWUICANDIDATEWINDOW 3
Mostrar a janela candidata do índice 3 pela janela de interface do usuário.

 

Retornar valor

Retorna o valor retornado por DefWindowProc ou ImmIsUIMessage.

Comentários

Se o aplicativo tiver criado uma janela IME, ele deverá chamar ImmIsUIMessage. Caso contrário, ele deverá passar essa mensagem para DefWindowProc.

Se o aplicativo desenhar a janela de composição, a janela padrão do IME não precisará mostrar sua janela de composição. Nesse caso, o aplicativo deve limpar o valor ISC_SHOWUICOMPOSITIONWINDOW do parâmetro lParam antes de passar a mensagem para DefWindowProc ou ImmIsUIMessage. Para exibir uma determinada janela de interface do usuário, um aplicativo deve remover o valor correspondente para que o IME não o exiba.

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]
Cabeçalho
Winuser.h (inclua Windows.h);
Imm.h (inclua Windows.h)

Confira também

Gerenciador de Métodos de Entrada

Mensagens do Gerenciador de Métodos de Entrada

ImmIsUIMessage