QVirtualKeyboardInputContext Class
Proporciona acceso a un contexto de entrada. Más...
| Encabezado: | #include <QVirtualKeyboardInputContext> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake: | QT += virtualkeyboard |
| En QML: | InputContext |
| Heredan de: | QObject |
Propiedades
|
|
Funciones públicas
| int | anchorPosition() const |
| bool | anchorRectIntersectsClipRect() const |
| QRectF | anchorRectangle() const |
| void | clear() |
| void | commit() |
| void | commit(const QString &text, int replaceFrom = 0, int replaceLength = 0) |
| int | cursorPosition() const |
| bool | cursorRectIntersectsClipRect() const |
| QRectF | cursorRectangle() const |
| QVirtualKeyboardInputEngine * | inputEngine() const |
| Qt::InputMethodHints | inputMethodHints() const |
| bool | isAnimating() const |
| bool | isCapsLockActive() const |
| bool | isSelectionControlVisible() const |
| bool | isShiftActive() const |
| bool | isUppercase() const |
| QVirtualKeyboardObserver * | keyboardObserver() const |
| QString | locale() const |
| QString | preeditText() const |
| QString | selectedText() const |
| void | sendKeyClick(int key, const QString &text, int modifiers = 0) |
| void | setAnimating(bool isAnimating) |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
| QString | surroundingText() const |
Señales
| void | anchorPositionChanged() |
| void | anchorRectIntersectsClipRectChanged() |
| void | anchorRectangleChanged() |
| void | animatingChanged() |
| void | capsLockActiveChanged() |
| void | cursorPositionChanged() |
| void | cursorRectIntersectsClipRectChanged() |
| void | cursorRectangleChanged() |
| void | inputMethodHintsChanged() |
| void | localeChanged() |
| void | preeditTextChanged() |
| void | selectedTextChanged() |
| void | selectionControlVisibleChanged() |
| void | shiftActiveChanged() |
| void | surroundingTextChanged() |
| void | uppercaseChanged() |
Documentación de propiedades
[read-only] anchorPosition : int
Esta propiedad almacena la posición del ancla.
Esta propiedad cambia cuando cambia la posición de anclaje.
Funciones de acceso:
| int | anchorPosition() const |
Señal de notificación:
| void | anchorPositionChanged() |
[read-only] anchorRectIntersectsClipRect : bool
Devuelve « true » si el rectángulo delimitador del ancla de selección se cruza con el rectángulo del elemento de entrada visible.
Funciones de acceso:
| bool | anchorRectIntersectsClipRect() const |
Señal de notificación:
| void | anchorRectIntersectsClipRectChanged() |
Véase también ` Qt::ImAnchorRectangle ` y ` Qt::ImInputItemClipRectangle`.
[read-only] anchorRectangle : QRectF
Esta propiedad contiene el rectángulo de anclaje.
Esta propiedad cambia cuando cambia el rectángulo de anclaje.
Funciones de acceso:
| QRectF | anchorRectangle() const |
Señal de notificación:
| void | anchorRectangleChanged() |
animating : bool
Esta propiedad contiene el estado de animación.
Utiliza esta propiedad para establecer el estado de animación, por ejemplo, durante los estados de transición de la interfaz de usuario.
Funciones de acceso:
| bool | isAnimating() const |
| void | setAnimating(bool isAnimating) |
Señal de notificador:
| void | animatingChanged() |
[read-only] capsLockActive : bool
Esta propiedad almacena el estado de la tecla Bloq Mayús.
Esta propiedad cambia cuando cambia el estado de Bloq Mayús.
Funciones de acceso:
| bool | isCapsLockActive() const |
Señal de notificación:
| void | capsLockActiveChanged() |
[read-only] cursorPosition : int
Esta propiedad almacena la posición del cursor.
Esta propiedad cambia cuando cambia la posición del cursor.
Funciones de acceso:
| int | cursorPosition() const |
Señal de notificación:
| void | cursorPositionChanged() |
[read-only] cursorRectIntersectsClipRect : bool
Devuelve ` true ` si el rectángulo delimitador del cursor de entrada se cruza con el rectángulo del elemento de entrada expuesto.
Funciones de acceso:
| bool | cursorRectIntersectsClipRect() const |
Señal de notificación:
| void | cursorRectIntersectsClipRectChanged() |
Véase también Qt::ImCursorRectangle y Qt::ImInputItemClipRectangle.
[read-only] cursorRectangle : QRectF
Esta propiedad contiene el rectángulo del cursor.
Esta propiedad cambia cuando cambia el rectángulo del cursor.
Funciones de acceso:
| QRectF | cursorRectangle() const |
Señal de notificación:
| void | cursorRectangleChanged() |
[read-only] inputEngine : QVirtualKeyboardInputEngine* const
Esta propiedad contiene el motor de entrada.
Esta propiedad almacena el motor de entrada.
Funciones de acceso:
| QVirtualKeyboardInputEngine * | inputEngine() const |
[read-only] inputMethodHints : Qt::InputMethodHints
Esta propiedad contiene las sugerencias del método de entrada.
Esta propiedad cambia cuando cambian las sugerencias del método de entrada.
Funciones de acceso:
| Qt::InputMethodHints | inputMethodHints() const |
Señal de notificación:
| void | inputMethodHintsChanged() |
[read-only, since 6.1] keyboardObserver : QVirtualKeyboardObserver* const
Almacena el objeto observador del teclado, que se puede utilizar para recibir notificaciones de eventos de cambio en el teclado.
Esta enumeración se introdujo en Qt 6.1.
Funciones de acceso:
| QVirtualKeyboardObserver * | keyboardObserver() const |
[read-only] locale : QString
Esta propiedad contiene la configuración regional.
Esta propiedad cambia cuando cambia la configuración regional de entrada.
Funciones de acceso:
| QString | locale() const |
Señal de notificación:
| void | localeChanged() |
preeditText : QString
Esta propiedad contiene el texto previo a la edición.
Esta propiedad establece el texto previo a la edición.
Funciones de acceso:
| QString | preeditText() const |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
Señal de notificación:
| void | preeditTextChanged() |
[read-only] selectedText : QString
Esta propiedad contiene el texto seleccionado.
Esta propiedad cambia cuando cambia el texto seleccionado.
Funciones de acceso:
| QString | selectedText() const |
Señal de notificación:
| void | selectedTextChanged() |
[read-only] selectionControlVisible : bool
Almacena el valor « true » si el control de selección está visible en ese momento.
Funciones de acceso:
| bool | isSelectionControlVisible() const |
Señal de notificación:
| void | selectionControlVisibleChanged() |
[read-only] shiftActive : bool
Esta propiedad contiene el estado del turno.
Esta propiedad se modifica cuando cambia el estado del turno.
Funciones de acceso:
| bool | isShiftActive() const |
Señal de notificación:
| void | shiftActiveChanged() |
[read-only] surroundingText : QString
Esta propiedad contiene el texto que rodea al cursor.
Esta propiedad cambia cuando cambia el texto que rodea el cursor.
Funciones de acceso:
| QString | surroundingText() const |
Señal de notificación:
| void | surroundingTextChanged() |
[read-only] uppercase : bool
Esta propiedad indica si las mayúsculas están activadas.
Esta propiedad es de tipo « true » cuando « shiftActive » o « capsLockActive » son de tipo « true ».
Funciones de acceso:
| bool | isUppercase() const |
Señal de notificación:
| void | uppercaseChanged() |
Documentación de funciones de miembro
[invokable] void QVirtualKeyboardInputContext::clear()
Borra el texto de preedición.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit()
Guarda el texto actual antes de la edición.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)
Aplica la « text » final al elemento de entrada y, opcionalmente, modifica el texto en relación con el inicio del texto previo a la edición. Si « replaceFrom » es distinto de cero, la « text » sustituye el contenido relativo a « replaceFrom » con una longitud de « replaceLength ».
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)
Envía un evento de pulsación de tecla con los valores especificados de « key », « text » y « modifiers » al elemento de entrada que tiene el foco en ese momento.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
© 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.