QInputMethod Class

Documentación de las funciones miembro

[slot] void QInputMethod::commit()

Guarda en el editor la palabra que el usuario está escribiendo en ese momento. La función es necesaria sobre todo para los métodos de entrada con características de predicción de texto y para los métodos en los que el guión utilizado para escribir caracteres es diferente del guión que realmente se añade al editor. Cualquier tipo de acción que interrumpa la composición del texto necesita vaciar el estado de composición llamando a la función commit(), por ejemplo cuando el cursor se mueve a otro lugar.

[slot] void QInputMethod::hide()

Solicita el cierre del teclado virtual.

Normalmente las aplicaciones no deberían necesitar llamar a esta función, el teclado debería cerrarse automáticamente cuando el editor de texto pierde el foco, por ejemplo cuando se cierra la vista padre.

QRectF QInputMethod::inputItemRectangle() const

Devuelve la geometría del elemento de entrada en coordenadas de elemento de entrada.

Véase también setInputItemRectangle().

QTransform QInputMethod::inputItemTransform() const

Devuelve la transformación de las coordenadas del elemento de entrada a las coordenadas de la ventana.

Véase también setInputItemTransform().

[slot] void QInputMethod::invokeAction(QInputMethod::Action a, int cursorPosition)

Llamado por el elemento de entrada cuando la palabra que se está componiendo en ese momento es pulsada por el usuario, tal y como indica la acción a y el cursorPosition dado. Los métodos de entrada suelen utilizar esta información para ofrecer más sugerencias de palabras al usuario.

[static] QVariant QInputMethod::queryFocusObject(Qt::InputMethodQuery query, const QVariant &argument)

Envía query al objeto de foco actual con los parámetros argument y devuelve el resultado.

[slot] void QInputMethod::reset()

Restablece el estado del método de entrada. Por ejemplo, un editor de texto normalmente llama a este método antes de insertar un texto para que el widget esté listo para aceptar un texto.

El método de entrada se restablece automáticamente cuando cambia el editor enfocado.

void QInputMethod::setInputItemRectangle(const QRectF &rect)

Establece la geometría del elemento de entrada en rect, en las coordenadas del elemento de entrada. Esto necesita ser actualizado por la ventana enfocada como QQuickCanvas cada vez que el item es movido dentro de la escena, o el foco es cambiado.

Ver también inputItemRectangle().

void QInputMethod::setInputItemTransform(const QTransform &transform)

Establece la transformación de las coordenadas del elemento de entrada a las coordenadas de la ventana en transform. El item transform necesita ser actualizado por la ventana enfocada como QQuickCanvas cada vez que el item es movido dentro de la escena.

Ver también inputItemTransform().

void QInputMethod::setVisible(bool visible)

Controla la visibilidad del teclado. Equivale a llamar a show() (si visible es true) o hide() (si visible es false).

Véase también isVisible(), show() y hide().

[slot] void QInputMethod::show()

Solicita que se abra el teclado virtual. Si la plataforma no proporciona teclado virtual la visibilidad permanece falsa.

Normalmente las aplicaciones no deberían necesitar llamar a esta función, el teclado debería abrirse automáticamente cuando el editor de texto obtiene el foco.

[slot] void QInputMethod::update(Qt::InputMethodQueries queries)

Llamada por el elemento de entrada para informar a los métodos de entrada de la plataforma cuando ha habido cambios de estado en los atributos de consulta del método de entrada del editor. Al llamar a la función queries parámetro tiene que ser utilizado para decir lo que ha cambiado, que el método de entrada puede utilizar para hacer consultas para los atributos que le interesa con QInputMethodQueryEvent.

En particular, es importante llamar a update siempre que cambie la posición del cursor, ya que esto a menudo provoca que también cambien otros atributos de consulta, como el texto circundante y la selección de texto. Los atributos que suelen cambiar junto con la posición del cursor se han agrupado en Qt::ImQueryInput para mayor comodidad.