mensaje de WM_IME_COMPOSITION

Artículo
06/13/2023

Se envía a una aplicación cuando el IME cambia el estado de composición como resultado de una pulsación de tecla. Una ventana recibe este mensaje a través de la función WindowProc.

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

Parámetros

hwnd

Identificador de ventana.

wParam

Carácter DBCS que representa el último cambio en la cadena de composición.

lParam

Valor que especifica cómo ha cambiado la cadena de composición o el carácter. Este parámetro puede ser uno o más de los siguientes valores. Para obtener más información sobre estos valores, vea Valores de cadena de composición de 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

El parámetro lParam también puede tener uno o varios de los valores siguientes.

Value	Significado
CS_INSERTCHAR	Inserte el carácter de composición wParam en el punto de inserción actual. Una aplicación debe mostrar el carácter de composición si procesa este mensaje.
CS_NOMOVECARET	No mueva la posición del símbolo de intercalación como resultado del procesamiento del mensaje. Por ejemplo, si un IME especifica una combinación de CS_INSERTCHAR y CS_NOMOVECARET, la aplicación debe insertar el carácter especificado en la posición del símbolo de intercalación actual, pero no debe mover el símbolo de intercalación a la siguiente posición. Un mensaje de WM_IME_COMPOSITION posterior con GCS_RESULTSTR reemplazará este carácter.

Value

Significado

CS_INSERTCHAR

Inserte el carácter de composición wParam en el punto de inserción actual. Una aplicación debe mostrar el carácter de composición si procesa este mensaje.

CS_NOMOVECARET

No mueva la posición del símbolo de intercalación como resultado del procesamiento del mensaje. Por ejemplo, si un IME especifica una combinación de CS_INSERTCHAR y CS_NOMOVECARET, la aplicación debe insertar el carácter especificado en la posición del símbolo de intercalación actual, pero no debe mover el símbolo de intercalación a la siguiente posición. Un mensaje de WM_IME_COMPOSITION posterior con GCS_RESULTSTR reemplazará este carácter.

Valor devuelto

Este mensaje no tiene ningún valor devuelto.

Observaciones

Una aplicación debe procesar este mensaje si muestra los caracteres de composición. De lo contrario, debe enviar el mensaje a la ventana IME.

Si la aplicación ha creado una ventana IME, debe pasar este mensaje a esa ventana. La función DefWindowProc procesa este mensaje pasandolo a la ventana de IME predeterminada. La ventana IME procesa este mensaje actualizando su apariencia en función de la marca de cambio especificada. Una aplicación puede llamar a ImmGetCompositionString para recuperar el nuevo estado de composición.

Si no se establece ninguno de los valores de GCS_, el mensaje indica que la composición actual se ha cancelado y las aplicaciones que dibujan la cadena de composición deben eliminar la cadena.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluye Windows.h); Imm.h (incluya Windows.h)

Consulte también

Administrador de métodos de entrada
Mensajes del Administrador de métodos de entrada
ImmGetCompositionString