WM_IME_COMPOSITION mensagem

Enviado para um aplicativo quando o IME altera a composição status como resultado de um pressionamento de tecla. Uma janela recebe essa mensagem por meio da função WindowProc.

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

Parâmetros

hwnd

Um identificador para janela.

wParam

Caractere DBCS que representa a alteração mais recente na cadeia de caracteres de composição.

lParam

Valor que especifica como a cadeia de caracteres ou a composição foi alterada. Esse parâmetro pode usar um dos valores a seguir. Para obter mais informações sobre esses valores, consulte Valores de cadeia de caracteres de composição do IME.

GCS_COMPATTR

GCS_COMPCLAUSE

GCS_COMPREADSTR

GCS_COMPREADATTR

GCS_COMPREADCLAUSE

GCS_COMPSTR

GCS_CURSORPOS

GCS_DELTASTART

GCS_RESULTCLAUSE

GCS_RESULTREADCLAUSE

GCS_RESULTREADSTR

GCS_RESULTSTR

O parâmetro lParam também pode ter um ou mais dos valores a seguir.

Valor	Significado
CS_INSERTCHAR	Insira o caractere de composição wParam no ponto de inserção atual. Um aplicativo deverá exibir o caractere de composição se processar essa mensagem.
CS_NOMOVECARET	Não mova a posição do cursor como resultado do processamento da mensagem. Por exemplo, se um IME especificar uma combinação de CS_INSERTCHAR e CS_NOMOVECARET, o aplicativo deverá inserir o caractere especificado na posição atual do cursor, mas não deve mover o cursor para a próxima posição. Uma mensagem WM_IME_COMPOSITION subsequente com GCS_RESULTSTR substituirá esse caractere.

 

Retornar valor

Esta mensagem não tem nenhum valor retornado.

Comentários

Um aplicativo deverá processar essa mensagem se exibir caracteres de composição em si. Caso contrário, ele deverá enviar a mensagem para a janela IME.

Se o aplicativo tiver criado uma janela IME, ele deverá passar essa mensagem para essa janela. A função DefWindowProc processa essa mensagem passando-a para a janela padrão do IME. A janela IME processa essa mensagem atualizando sua aparência com base no sinalizador de alteração especificado. Um aplicativo pode chamar ImmGetCompositionString para recuperar a nova composição status.

Se nenhum dos valores de GCS_ estiver definido, a mensagem indicará que a composição atual foi cancelada e os aplicativos que desenham a cadeia de caracteres de composição devem excluir a cadeia de caracteres.

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

Immgetcompositionstring