En esta página

InputContext QML Type (Singleton)

Proporciona acceso a un contexto de entrada. Más...

Import Statement: import QtQuick.VirtualKeyboard
In C++: QVirtualKeyboardInputContext

Nota: Este tipo es un singleton QML. Sólo hay una instancia de este tipo en el motor QML.

Propiedades

Métodos

Descripción detallada

Se puede acceder al InputContext como instancia singleton.

Documentación de propiedades

anchorPosition : int [read-only, since QtQuick.VirtualKeyboard 2.2]

Esta propiedad se modifica cuando cambia la posición del ancla.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.2.

anchorRectIntersectsClipRect : bool [read-only]

Indica true si el rectángulo delimitador del ancla de selección interseca el rectángulo del elemento de entrada expuesto.

Véase también Qt::ImAnchorRectangle y Qt::ImInputItemClipRectangle.

anchorRectangle : rect [read-only, since QtQuick.VirtualKeyboard 2.1]

Esta propiedad se modifica cuando cambia el rectángulo de anclaje.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.1.

animating : bool

Utilice esta propiedad para establecer el estado de animación, por ejemplo durante los estados de transición de la interfaz de usuario.

capsLockActive : bool [read-only, since QtQuick.VirtualKeyboard 2.4]

Esta propiedad cambia cuando cambia el estado de bloqueo de mayúsculas.

Esta propiedad fue introducida en QtQuick.VirtualKeyboard 2.4.

cursorPosition : int [read-only]

Esta propiedad se modifica cuando cambia la posición del cursor.

cursorRectIntersectsClipRect : bool [read-only]

Indica true si el rectángulo del cursor de entrada se cruza con el rectángulo del elemento de entrada expuesto.

Véase también Qt::ImCursorRectangle y Qt::ImInputItemClipRectangle.

cursorRectangle : rect [read-only]

Esta propiedad se modifica cuando cambia el rectángulo del cursor.

inputEngine : InputEngine [read-only]

Esta propiedad almacena el motor de entrada.

inputMethodHints : int [read-only]

Esta propiedad se modifica cuando cambian las sugerencias del método de entrada.

keyboardObserver : KeyboardObserver [read-only, since 6.1]

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.

locale : string [read-only]

Esta propiedad se modifica cuando cambia la configuración regional de entrada.

preeditText : string

Esta propiedad establece el texto previo a la edición.

selectedText : string [read-only]

Esta propiedad se modifica cuando cambia el texto seleccionado.

selectionControlVisible : bool [read-only]

Indica true si el control de selección está visible en ese momento.

shiftActive : bool [read-only, since QtQuick.VirtualKeyboard 2.4]

Esta propiedad se modifica cuando cambia el estado del turno.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.4.

surroundingText : string [read-only]

Esta propiedad se modifica cuando cambia el texto que rodea al cursor.

uppercase : bool [read-only, since QtQuick.VirtualKeyboard 2.2]

Esta propiedad es true cuando shiftActive o capsLockActive es true.

Esta propiedad fue introducida en QtQuick.VirtualKeyboard 2.2.

Documentación del método

void clear()

Borra el texto previo a la edición.

void commit()

Confirma el texto pre-editado.

void commit(string text, int replaceFrom = 0, int replaceLength = 0)

Consigna el texto final de text en el elemento de entrada y, opcionalmente, modifica el texto en relación con el inicio del texto anterior a la edición. Si replaceFrom es distinto de cero, text sustituye el contenido relativo a replaceFrom con una longitud de replaceLength.

void sendKeyClick(int key, string 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.

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