Cadena de composición
La cadena de composición es el texto actual de la ventana de composición. Este es el texto que el IME convierte en caracteres finales. Cada cadena de composición consta de una o varias "cláusulas". Una cláusula es la combinación más pequeña de caracteres que el IME puede convertir en un carácter final. Para obtener y establecer la cadena de composición, la aplicación llama a las funciones ImmGetCompositionString e ImmSetCompositionString , respectivamente.
Cuando el usuario escribe texto en la ventana de composición, el IME realiza un seguimiento del estado de la cadena de composición. Este estado incluye información de atributo, información de cláusulas, información de escritura y posición del cursor. La aplicación puede recuperar el estado de composición mediante la función ImmGetCompositionString .
La información de atributo se representa en una matriz de valores de 8 bits que especifica el estado de los caracteres de la cadena de composición. Todos los caracteres de una cláusula deben tener el mismo atributo. La matriz incluye un valor para cada byte de la cadena, incluido un byte cada uno para el cliente potencial y el segundo bytes de los caracteres de doble byte de la cadena. Para cada valor de la matriz, los bits entre 0 y 3 pueden ser una combinación de los valores siguientes.
| Value | Significado |
|---|---|
| ATTR_INPUT | Carácter escrito por el usuario. El IME todavía tiene que convertir este carácter. |
| ATTR_INPUT_ERROR | Carácter de error que el IME no puede convertir. Por ejemplo, el IME no puede reunir algunas consonantes. |
| ATTR_TARGET_CONVERTED | Carácter seleccionado por el usuario y convertido por el IME. |
| ATTR_CONVERTED | Carácter que el IME ya ha convertido. |
| ATTR_TARGET_NOTCONVERTED | Carácter convertido. El usuario ha seleccionado este carácter, pero el IME aún no lo ha convertido. |
| ATTR_FIXEDCONVERTED | Los caracteres que el IME ya no convertirá. |
Todos los demás valores están reservados. En japonés, cualquier carácter sin convertir que tenga el atributo ATTR_INPUT es un carácter hiragana, katakana o alfanumérico. En coreano, este atributo representa un carácter Hangul que el IME aún no ha convertido. En chino tradicional y chino simplificado, cada IME puede limitar su carácter dentro de algún intervalo.
La información de la cláusula incluida en el estado de la cadena de composición es una matriz de valores de 32 bits que especifica las posiciones de las cláusulas de la cadena de composición. La matriz incluye un valor para cada cláusula y un valor final que especifica la longitud de la cadena completa. Cada valor de la matriz especifica el desplazamiento, en bytes, desde el principio de la cadena hasta la cláusula . El primer valor siempre es 0 porque la primera cláusula siempre comienza al principio de la cadena. Por ejemplo, si una cadena tiene dos cláusulas, la información de la cláusula tiene tres valores: el primer valor es 0, el segundo valor es el desplazamiento de la segunda cláusula y el tercer valor es la longitud de la cadena. Para Unicode, la posición de una cláusula se cuenta en caracteres Unicode y la longitud de una cadena es el tamaño en caracteres Unicode.
La información de escritura incluida en el estado de la cadena de composición es una cadena de caracteres terminada en null que representa los caracteres que el usuario escribe en el teclado.
La posición del cursor incluida en el estado de la cadena de composición es un valor que indica la posición del cursor con respecto a los caracteres de la cadena de composición. El valor es el desplazamiento, en bytes, desde el principio de la cadena. Si este valor es 0, el cursor se encuentra inmediatamente antes del primer carácter de la cadena. Si el valor es igual a la longitud de la cadena, el cursor se encuentra inmediatamente después del último carácter. Si el valor es 1, el cursor no está presente. Para Unicode, tanto la posición como la longitud se miden en caracteres Unicode.
La aplicación puede establecer la cadena de composición o los elementos del estado de composición mediante la función ImmSetCompositionString . Para asegurarse de que la ventana de composición actualiza su apariencia en función de estos cambios, la función permite a la aplicación enviar un mensaje de notificación a la ventana. Las aplicaciones que establecen una combinación de elementos de estado de composición normalmente deshabilitan las notificaciones para todas las llamadas a esta función, de modo que solo se genere un mensaje de notificación para la ventana de composición.
Por último, el control de edición admite dos mensajes para cambiar el control de cadenas de composición por el IME. Para obtener más información, consulte EM_GETIMESTATUS y EM_SETIMESTATUS. Para obtener más información sobre el control de edición, vea Editar control.
Temas relacionados