Compartir a través de


mensaje de WM_IME_COMPOSITION

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.

 

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