QInputMethodEvent Class

Descripción Detallada

Los eventos de método de entrada se envían a los widgets cuando se utiliza un método de entrada para introducir texto en un widget. Los métodos de entrada son muy utilizados para introducir texto en idiomas con alfabetos no latinos.

Tenga en cuenta que al crear widgets de edición de texto personalizados, el atributo de ventana Qt::WA_InputMethodEnabled debe establecerse explícitamente (utilizando la función QWidget::setAttribute()) para poder recibir eventos de método de entrada.

Estos eventos son de interés para los autores de widgets de entrada de teclado que deseen manejar correctamente idiomas con entrada de caracteres compleja. La introducción de texto en dichos idiomas suele ser un proceso de tres pasos:

1. Inicio de la composición

   Cuando el usuario pulsa la primera tecla de un teclado, se crea un contexto de entrada. Este contexto de entrada contendrá una cadena con los caracteres tecleados.

2. Composición

   Con cada nueva tecla pulsada, el método de entrada intentará crear una cadena coincidente con el texto tecleado hasta el momento, denominada cadena de preedición. Mientras el contexto de entrada esté activo, el usuario sólo podrá mover el cursor dentro de la cadena perteneciente a este contexto de entrada.

3. Completar

   En algún momento, el usuario activará un componente de la interfaz de usuario (quizás utilizando una tecla concreta) donde podrá elegir entre una serie de cadenas que coincidan con el texto que ha escrito hasta el momento. El usuario puede confirmar su elección o cancelar la entrada; en cualquier caso, el contexto de entrada se cerrará.

QInputMethodEvent modela estas tres etapas, y transfiere la información necesaria para renderizar correctamente el resultado intermedio. Un QInputMethodEvent tiene dos parámetros principales: preeditString() y commitString(). El parámetro preeditString() da la cadena de preedición actualmente activa. El parámetro commitString() da un texto que debería añadirse (o reemplazar partes de) el texto del widget del editor. Normalmente es el resultado de las operaciones de entrada y debe insertarse en el texto del widget directamente antes de la cadena de preedición.

Si commitString() debe reemplazar partes del texto del editor, replacementLength() contendrá el número de caracteres a reemplazar. replacementStart() contiene la posición en la que los caracteres deben ser reemplazados en relación con el inicio de la cadena preedit.

Una serie de atributos controlan el aspecto visual de la cadena de preedición (el aspecto visual del texto fuera de la cadena de preedición sólo lo controla el widget). El enum AttributeType describe los diferentes atributos que se pueden establecer.

Una clase que implemente QWidget::inputMethodEvent() o QGraphicsItem::inputMethodEvent() debería al menos entender y respetar los atributos TextFormat y Cursor.

Dado que los métodos de entrada deben poder consultar ciertas propiedades del widget o del elemento gráfico, las subclases también deben implementar QWidget::inputMethodQuery() y QGraphicsItem::inputMethodQuery(), respectivamente.

Al recibir un evento de método de entrada, el widget de texto tiene que realizar los siguientes pasos:

1. Si el widget tiene texto seleccionado, el texto seleccionado debe ser eliminado.
2. Elimina el texto que empieza en replacementStart() con la longitud replacementLength() y lo sustituye por el commitString(). Si replacementLength() es 0, replacementStart() da la posición de inserción para commitString().

   Al hacer el reemplazo se ignora el área de la cadena de preedición, por lo que un reemplazo que comience en -1 con una longitud de 2 eliminará el último carácter antes de la cadena de preedición y el primer carácter después, e insertará la cadena de confirmación directamente antes de la cadena de preedición.

   Si el widget implementa deshacer/rehacer, esta operación se añade a la pila de deshacer.

3. Si no hay ninguna cadena de preedición actual, inserta el preeditString() en la posición actual del cursor; en caso contrario, reemplaza el preeditString anterior por el recibido de este evento.

   Si el widget implementa deshacer/rehacer, preeditString() no debería influir de ninguna manera en la pila de deshacer/rehacer.

   El widget debe examinar la lista de atributos a aplicar a la cadena preeditada. Tiene que entender al menos los atributos TextFormat y Cursor y renderizarlos como se especifique.