En esta página

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

Descripción detallada

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:

[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:

[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.