En esta página

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

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.

ConstanteValorDescripción
QInputMethod::Click0Un clic o toque normal
QInputMethod::ContextMenu1Un 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()

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

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.