QInputMethod Class
La clase QInputMethod permite acceder al método de introducción de texto activo. Más información...
| Encabezado: | #include <QInputMethod> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QObject |
Tipos públicos
| enum | Action { Click, ContextMenu } |
Propiedades
|
|
Funciones públicas
| QRectF | anchorRectangle() const |
| QRectF | cursorRectangle() const |
| Qt::LayoutDirection | inputDirection() const |
| QRectF | inputItemClipRectangle() const |
| QRectF | inputItemRectangle() const |
| QTransform | inputItemTransform() const |
| bool | isAnimating() const |
| bool | isVisible() const |
| QRectF | keyboardRectangle() const |
| QLocale | locale() const |
| void | setInputItemRectangle(const QRectF &rect) |
| void | setInputItemTransform(const QTransform &transform) |
| void | setVisible(bool visible) |
Ranuras públicas
| void | commit() |
| void | hide() |
| void | invokeAction(QInputMethod::Action a, int cursorPosition) |
| void | reset() |
| void | show() |
| void | update(Qt::InputMethodQueries queries) |
Señales
| void | anchorRectangleChanged() |
| void | animatingChanged() |
| void | cursorRectangleChanged() |
| void | inputDirectionChanged(Qt::LayoutDirection newDirection) |
| void | inputItemClipRectangleChanged() |
| void | keyboardRectangleChanged() |
| void | localeChanged() |
| void | visibleChanged() |
Miembros públicos estáticos
| QVariant | queryFocusObject(Qt::InputMethodQuery query, const QVariant &argument) |
Descripción detallada
QInputMethod es utilizado por los editores de texto para integrarse con los métodos de entrada de texto de la plataforma y, más comúnmente, por las vistas de las aplicaciones para consultar diversa información relacionada con los métodos de entrada de texto, como la visibilidad del teclado virtual y las dimensiones del teclado.
Qt Quick También proporciona acceso a QInputMethod en QML a través de ` Qt global object ` como la propiedad ` Qt.inputMethod `.
Documentación sobre el tipo de miembro
enum QInputMethod::Action
Indica el tipo de acción realizada por el usuario.
| Constante | Valor | Descripción |
|---|---|---|
QInputMethod::Click | 0 | Un clic o toque normal |
QInputMethod::ContextMenu | 1 | Un clic o toque en el menú contextual (por ejemplo, botón derecho o tocar y mantener pulsado) |
Véase también invokeAction().
Documentación de propiedades
[read-only] anchorRectangle : QRectF
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.
Funciones de acceso:
| QRectF | anchorRectangle() const |
Señal de notificación:
| void | anchorRectangleChanged() |
[read-only] animating : bool
Es verdadero cuando se está abriendo o cerrando el teclado virtual.
La animación 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.
Funciones de acceso:
| bool | isAnimating() const |
Señal de notificación:
| void | animatingChanged() |
[read-only] cursorRectangle : QRectF
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.
Funciones de acceso:
| QRectF | cursorRectangle() const |
Señal de notificación:
| void | cursorRectangleChanged() |
[read-only] inputDirection : Qt::LayoutDirection
Dirección de entrada de corriente.
Funciones de acceso:
| Qt::LayoutDirection | inputDirection() const |
Señal del notificador:
| void | inputDirectionChanged(Qt::LayoutDirection newDirection) |
[read-only] inputItemClipRectangle : QRectF
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).
Funciones de acceso:
| QRectF | inputItemClipRectangle() const |
Señal de notificación:
| void | inputItemClipRectangleChanged() |
[read-only] keyboardRectangle : QRectF
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.
Funciones de acceso:
| QRectF | keyboardRectangle() const |
Señal de notificador:
| void | keyboardRectangleChanged() |
[read-only] locale : QLocale
Configuración regional de entrada actual.
Funciones de acceso:
| QLocale | locale() const |
Señal de notificación:
| void | localeChanged() |
[read-only] visible : bool
Visibilidad del teclado virtual en la pantalla
La visibilidad del método de entrada sigue siendo «false» en los dispositivos que no disponen de teclado virtual.
Funciones de acceso:
| bool | isVisible() const |
Señal de notificación:
| void | visibleChanged() |
Documentación de funciones de miembro
[slot] void QInputMethod::commit()
Guarda en el editor el texto que el usuario está escribiendo en ese momento. Esta función es necesaria sobre todo en los métodos de entrada con funciones de predicción de texto y en aquellos en los que el código 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.
[slot] void QInputMethod::hide()
Solicita que se cierre el 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.
QRectF QInputMethod::inputItemRectangle() const
Devuelve la geometría del elemento de entrada en las coordenadas de dicho elemento.
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)
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 facilitado. 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 la función « query » al objeto actualmente seleccionado 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 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 QInputMethod::setInputItemRectangle(const QRectF &rect)
Establece la geometría del elemento de entrada en ` rect`, en coordenadas del elemento de entrada. La ventana que tiene el foco, como QQuickCanvas, debe actualizar este valor cada vez que el elemento se mueva dentro de la escena o se cambie el foco.
Véase 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 como ` transform`. La transformación del elemento debe ser actualizada por la ventana activa, como QQuickCanvas, cada vez que el elemento se mueva dentro de la escena.
Véase también inputItemTransform().
void QInputMethod::setVisible(bool visible)
Controla la visibilidad del teclado. Equivale a llamar a ` show()` (si ` visible ` es ` true`) o a ` 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 dispone de teclado virtual, la propiedad «visibility» se mantiene en «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.
[slot] void QInputMethod::update(Qt::InputMethodQueries 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, lo que permite al método de entrada realizar consultas sobre los atributos que le interesan mediante « QInputMethodQueryEvent ».
En particular, es importante llamar a «update» cada vez que cambie la posición del cursor, ya que esto suele provocar 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 el valor « Qt::ImQueryInput » para mayor comodidad.
© 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.