InputMethod QML Type (Singleton)
Proporciona acceso a QInputMethod para aplicaciones QML. Más...
| Import Statement: | import QtQuick |
| Since: | Qt 6.4 |
Nota: Este tipo es un singleton de QML. Solo hay una instancia de este tipo en el motor de QML.
Propiedades
- anchorRectangle : rect
- animating : bool
- cursorRectangle : rect
- inputDirection : enumeration
- inputItemClipRectangle : rect
- keyboardRectangle : rect
- locale : Locale
- visible : bool
Métodos
- void commit()
- void hide()
- void invokeAction(var a, int cursorPosition)
- void reset()
- void show()
- void update(enumeration queries)
Descripción detallada
El singleton InputMethod permite acceder al objeto ` QInputMethod ` de la aplicación y a todas sus propiedades y ranuras. Consulta la documentación de QInputMethod para obtener más detalles.
Documentación de las propiedades
anchorRectangle : rect
Introduce el rectángulo de anclaje del elemento en coordenadas de ventana.
El rectángulo de anclaje suele utilizarse en diversos controles de edición de texto, como las ventanas emergentes de predicción de texto, para seguir la selección de texto.
animating : bool
Es verdadero cuando se está abriendo o cerrando el teclado virtual.
El valor de esta propiedad es «false» cuando el teclado está completamente abierto o cerrado. Cuando animating es true y visibility es true, el teclado se está abriendo. Cuando animating es true y visibility es «false», el teclado se está cerrando.
cursorRectangle : rect
Rectángulo del cursor del elemento de entrada en coordenadas de ventana.
El rectángulo del cursor se utiliza a menudo en diversos controles de edición de texto, como las ventanas emergentes de predicción de texto, para seguir el texto que se está escribiendo.
inputDirection : enumeration
Dirección de entrada de la corriente.
Valores posibles:
| Constante | Descripción |
|---|---|
Qt.LeftToRight | (por defecto) Los elementos se disponen de izquierda a derecha. |
Qt.RightToLeft | Los elementos se disponen de derecha a izquierda. |
inputItemClipRectangle : rect
Rectángulo recortado del elemento de entrada en coordenadas de ventana.
El rectángulo recortado de entrada suele ser utilizado por diversos métodos de entrada para determinar cuánto espacio de pantalla hay disponible para el método de entrada (por ejemplo, el teclado virtual).
keyboardRectangle : rect
Geometría del teclado virtual en coordenadas de ventana.
Puede tratarse de un rectángulo vacío si no es posible conocer la geometría del teclado. Este es el caso de un teclado flotante en Android.
locale : Locale
Configuración regional de entrada actual.
visible : bool
Visibilidad del teclado virtual en la pantalla
El valor de esta propiedad sigue siendo «false» en los dispositivos que no disponen de teclado virtual.
Véase también show() y hide().
Documentación del método
void commit()
Guarda en el editor la palabra que el usuario está escribiendo en ese momento. Esta función es especialmente necesaria para los métodos de entrada con funciones de predicción de texto y para aquellos en los que el alfabeto utilizado para escribir los caracteres es diferente del que realmente se añade al editor. Cualquier tipo de acción que interrumpa la redacción del texto debe vaciar el estado de redacción llamando a la función commit(), por ejemplo, cuando se desplaza el cursor a otra parte.
void hide()
Solicita el cierre del teclado virtual.
Normalmente, las aplicaciones no deberían tener que llamar a esta función, ya que el teclado debería cerrarse automáticamente cuando el editor de texto pierda el foco, por ejemplo, al cerrarse la vista principal.
void invokeAction(var a, int cursorPosition)
Se invoca desde el elemento de entrada cuando el usuario pulsa sobre la palabra que se está escribiendo en ese momento, tal y como indican la acción a y el cursorPosition. Los métodos de entrada suelen utilizar esta información para ofrecer más sugerencias de palabras al usuario.
Véase también QInputMethod::Action.
void reset()
Restablece el estado del método de entrada. Por ejemplo, un editor de texto suele llamar a este método antes de insertar un texto para que el widget esté listo para aceptar texto.
El método de entrada se restablece automáticamente cuando cambia el editor que tiene el foco.
void show()
Solicita que se abra el teclado virtual. Si la plataforma no dispone de teclado virtual, la propiedad «visibility» sigue siendo «false».
Normalmente, las aplicaciones no deberían tener que llamar a esta función, ya que el teclado debería abrirse automáticamente cuando el editor de texto reciba el foco.
void update(enumeration queries)
La función la invoca el elemento de entrada para informar a los métodos de entrada de la plataforma cuando se han producido cambios de estado en los atributos de consulta del método de entrada del editor. Al llamar a la función, se debe utilizar el parámetro ` queries ` para indicar qué ha cambiado. Un método de entrada puede utilizar esto para realizar consultas sobre los atributos que le interesan mediante ` QInputMethodQueryEvent`.
En concreto, es importante llamar a `update()` cada vez que cambie la posición del cursor, ya que eso suele provocar que otros atributos de consulta, como el texto circundante y la selección de texto, también cambien. Los atributos que suelen cambiar junto con la posición del cursor se han agrupado en el valor ` Qt::ImQueryInput ` para mayor comodidad.
Véase también Qt::InputMethodQueries.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.