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 |
|
Confira também