QVirtualKeyboardInputContext Class
Proporciona acceso a un contexto de entrada. Más...
| Cabecera: | #include <QVirtualKeyboardInputContext> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake: | QT += virtualkeyboard |
| En QML: | InputContext |
| Hereda: | 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 contiene la posición del ancla.
Esta propiedad se modifica cuando cambia la posición del ancla.
Funciones de acceso:
| int | anchorPosition() const |
Señal del notificador:
| void | anchorPositionChanged() |
[read-only] anchorRectIntersectsClipRect : bool
Indica true si el rectángulo delimitador del ancla de selección interseca el rectángulo del elemento de entrada expuesto.
Funciones de acceso:
| bool | anchorRectIntersectsClipRect() const |
Señal del notificador:
| 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 se modifica cuando cambia el rectángulo de anclaje.
Funciones de acceso:
| QRectF | anchorRectangle() const |
Señal del notificador:
| void | anchorRectangleChanged() |
animating : bool
Esta propiedad contiene el estado de animación.
Utilice 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 del notificador:
| void | animatingChanged() |
[read-only] capsLockActive : bool
Esta propiedad contiene el estado de bloqueo de mayúsculas.
Esta propiedad se modifica cuando cambia el estado de bloqueo de mayúsculas.
Funciones de acceso:
| bool | isCapsLockActive() const |
Señal del notificador:
| void | capsLockActiveChanged() |
[read-only] cursorPosition : int
Esta propiedad contiene la posición del cursor.
Esta propiedad se modifica cuando cambia la posición del cursor.
Funciones de acceso:
| int | cursorPosition() const |
Señal del notificador:
| void | cursorPositionChanged() |
[read-only] cursorRectIntersectsClipRect : bool
Indica true si el rectángulo delimitador del cursor de entrada interseca el rectángulo expuesto del elemento de entrada.
Funciones de acceso:
| bool | cursorRectIntersectsClipRect() const |
Señal notificadora:
| 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 se modifica cuando cambia el rectángulo del cursor.
Funciones de acceso:
| QRectF | cursorRectangle() const |
Señal del notificador:
| void | cursorRectangleChanged() |
[read-only] inputEngine : QVirtualKeyboardInputEngine* const
Esta propiedad guarda 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 se modifica cuando cambian las sugerencias del método de entrada.
Funciones de acceso:
| Qt::InputMethodHints | inputMethodHints() const |
Señal del notificador:
| void | inputMethodHintsChanged() |
[read-only, since 6.1] keyboardObserver : QVirtualKeyboardObserver* const
Contiene el objeto observador del teclado, que se puede utilizar para recibir notificaciones de eventos de cambio de teclado.
Esta propiedad 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 se modifica cuando cambia la configuración regional de entrada.
Funciones de acceso:
| QString | locale() const |
Señal del notificador:
| void | localeChanged() |
preeditText : QString
Esta propiedad mantiene el texto de pre-edición.
Esta propiedad establece el texto de pre-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 del notificador:
| void | preeditTextChanged() |
[read-only] selectedText : QString
Esta propiedad contiene el texto seleccionado.
Esta propiedad se modifica cuando cambia el texto seleccionado.
Funciones de acceso:
| QString | selectedText() const |
Señal del notificador:
| void | selectedTextChanged() |
[read-only] selectionControlVisible : bool
Indica true si el control de selección está visible en ese momento.
Funciones de acceso:
| bool | isSelectionControlVisible() const |
Señal del notificador:
| 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 del notificador:
| void | shiftActiveChanged() |
[read-only] surroundingText : QString
Esta propiedad contiene el texto que rodea al cursor.
Esta propiedad se modifica cuando cambia el texto que rodea al cursor.
Funciones de acceso:
| QString | surroundingText() const |
Señal del notificador:
| void | surroundingTextChanged() |
[read-only] uppercase : bool
Esta propiedad mantiene el estado de mayúsculas.
Esta propiedad es true cuando shiftActive o capsLockActive es true.
Funciones de acceso:
| bool | isUppercase() const |
Señal del notificador:
| void | uppercaseChanged() |
Documentación de la función miembro
[invokable] void QVirtualKeyboardInputContext::clear()
Borra el texto previo a la edición.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit()
Consigna el texto pre-editado actual.
Nota: Esta función puede invocarse 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)
Consigna el text final al elemento de entrada y opcionalmente modifica el texto relativo al inicio del texto pre-editado. Si replaceFrom es distinto de cero, text sustituye el contenido relativo a replaceFrom con una longitud de replaceLength.
Nota: Esta función puede invocarse 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 clic de tecla con los valores key, text y modifiers al elemento de entrada que tiene el foco en ese momento.
Nota: Esta función puede invocarse 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.
