En esta página

VirtualKeyboardSettings QML Type

Ofrece opciones de configuración para el teclado virtual. Más...

Import Statement: import QtQuick.VirtualKeyboard.Settings
Since: QtQuick.VirtualKeyboard 1.2

Propiedades

Señales

Descripción detallada

Este tipo proporciona una instancia singleton de VirtualKeyboardSettings, que se puede utilizar para configurar los ajustes del teclado virtual.

Ten en cuenta que los ajustes solo surten efecto mientras la aplicación está en ejecución; es decir, los cambios en la configuración no son permanentes.

Por ejemplo, para cambiar el estilo del teclado en la aplicación:

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

Documentación de propiedades

activeLocales : list<string> [since QtQuick.VirtualKeyboard.Settings 2.0]

Esta propiedad contiene una lista de los idiomas activados en el teclado virtual.

La lista de idiomas activos es un subconjunto de los idiomas disponibles y puede utilizarse para limitar la lista de idiomas disponibles durante el ciclo de vida de la aplicación.

La lista de idiomas se mostrará según el orden especificado.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Settings 2.0.

arrowKeyNavigationEnabled : bool [since 6.11]

Utiliza esta propiedad para activar o desactivar la navegación con las teclas de flecha.

Esta propiedad se introdujo en Qt 6.11.

availableLocales : list<string> [read-only, since QtQuick.VirtualKeyboard.Settings 2.0]

Esta propiedad contiene una lista de los idiomas compatibles con el teclado virtual.

Esta lista es de solo lectura y depende de la configuración del teclado virtual en el momento de la compilación.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Settings 2.0.

closeOnReturn : bool [since 6.8]

Esta propiedad permite ocultar el teclado virtual.

Cuando esta propiedad se establece en « true », el teclado virtual se oculta al soltar las teclas « Qt::Key_Enter » o « Qt::Key_Return ». El valor predeterminado es « false ».

Esta propiedad se introdujo en Qt 6.8.

defaultDictionaryDisabled : bool [since 6.1]

Esta propiedad desactiva el diccionario predeterminado. El objetivo de esta configuración es poder utilizar únicamente un diccionario personalizado en lugar del diccionario estándar.

Esta propiedad se introdujo en Qt 6.1.

defaultInputMethodDisabled : bool [since 6.1]

Esta propiedad desactiva el método de entrada predeterminado. El objetivo de esta configuración es poder sustituir el método de entrada predeterminado por el método de entrada básico, desactivando así su funcionalidad.

Esta propiedad se introdujo en Qt 6.1.

fullScreenMode : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

Esta propiedad activa el modo de pantalla completa para el teclado virtual.

En el modo de pantalla completa, el teclado virtual reproduce el contenido del campo de entrada activo en el campo de entrada de pantalla completa situado en la parte superior del teclado.

Teclado en modo de pantalla completa, con el contenido del campo activo reflejado en una barra situada encima de las teclas

Por ejemplo, para activar el modo de pantalla completa cuando la relación de aspecto de la pantalla es superior a 16:9:

Binding {
    target: VirtualKeyboardSettings
    property: "fullScreenMode"
    value: (Screen.width / Screen.height) > (16.0 / 9.0)
}

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Settings 2.2.

handwritingModeDisabled : bool [since 6.1]

Esta propiedad permite desactivar el modo de entrada mediante escritura a mano, si está disponible en el sistema.

Cuando esta propiedad se establece en « true », el botón de escritura a mano se oculta en la distribución del teclado y el usuario no puede cambiar al modo de entrada mediante escritura a mano.

Esta propiedad se introdujo en Qt 6.1.

hwrTimeoutForAlphabetic : bool [since 6.1]

Esta propiedad establece el tiempo de espera del reconocimiento de escritura manuscrita para los idiomas alfabéticos.

Por defecto, el tiempo de espera es de 500 milisegundos.

Esta propiedad se introdujo en Qt 6.1.

hwrTimeoutForCjk : bool [since 6.1]

Esta propiedad establece el tiempo de espera del reconocimiento de escritura manuscrita para los idiomas chino, japonés y coreano.

Por defecto, el tiempo de espera es de 500 milisegundos.

Esta propiedad se introdujo en Qt 6.1.

inputMethodHints : int [since 6.1]

Esta propiedad permite establecer sugerencias persistentes para el método de entrada.

El valor de esta propiedad se combina con las sugerencias del método de entrada del control de entrada. Por ejemplo, para desactivar la entrada de texto predictiva, esta propiedad se puede establecer en « Qt::ImhNoPredictiveText ».

Esta propiedad se introdujo en Qt 6.1.

keySoundVolume : real [since 6.9]

Esta propiedad contiene el nivel de volumen del sonido de la tecla. El nivel se encuentra en el intervalo [0,1]

Esta propiedad se introdujo en Qt 6.9.

locale : string [since QtQuick.VirtualKeyboard.Settings 2.0]

Esta propiedad establece la configuración regional predeterminada para el teclado.

Cuando no se especifica la configuración regional, se utiliza en su lugar la configuración regional predeterminada del sistema.

Si la configuración regional del teclado difiere de la nueva configuración regional predeterminada, el idioma del teclado cambia inmediatamente para reflejar la nueva configuración regional. Si la configuración regional es incorrecta o no figura en la lista de configuraciones regionales compatibles, se ignora y se utiliza la configuración predeterminada en su lugar.

Una configuración regional es compatible si está incluida en la lista de availableLocales.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Settings 2.0.

styleName : string

Esta propiedad establece el estilo actual. La aplicación puede cambiar el estilo del teclado asignando un valor diferente a «styleName».

El estilo del teclado en todo el sistema puede modificarse configurando la variable de entorno QT_VIRTUALKEYBOARD_STYLE.

userDataPath : bool [since 6.1]

Esta propiedad establece la ruta de datos de usuario para el teclado virtual y sus complementos.

Por defecto, la ruta de datos de usuario está establecida en GenericConfigLocation + "/qtvirtualkeyboard".

Esta propiedad se introdujo en Qt 6.1.

visibleFunctionKeys : enumeration [since 6.6]

Esta opción ajusta la visibilidad de determinadas teclas de función en la distribución del teclado, permitiendo mostrarlas u ocultarlas. Cuando una tecla de función no está visible, se puede seguir accediendo a su funcionalidad a través del menú de ajustes.

El valor puede ser una combinación de los siguientes indicadores:

  • QtVirtualKeyboard.KeyboardFunctionKeys.None Todas las teclas de función están ocultas
  • QtVirtualKeyboard.KeyboardFunctionKeys.Hide La tecla de función «Ocultar» está visible
  • QtVirtualKeyboard.KeyboardFunctionKeys.Language La tecla de función de idioma está visible
  • QtVirtualKeyboard.KeyboardFunctionKeys.All Todas las teclas de función están visibles

El valor por defecto es « QtVirtualKeyboard.KeyboardFunctionKeys.All ».

Esta propiedad se introdujo en Qt 6.6.

wordCandidateList group

wordCandidateList.alwaysVisible : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

wordCandidateList.autoHideDelay : int [since QtQuick.VirtualKeyboard.Settings 2.2]

NombreDescripción
autoHideDelayEsta propiedad define el retraso, en milisegundos, tras el cual se oculta la lista de palabras candidatas si está vacía.

Si el valor es « 0 », la lista se oculta inmediatamente al borrarla.

Si el valor es « -1 », la lista permanece visible hasta que cambia el foco de entrada o se oculta el panel de entrada.

El valor por defecto es « 5000 » milisegundos.

alwaysVisibleEsta propiedad define si la lista de palabras sugeridas debe permanecer siempre visible.

El valor por defecto es false.

autoCommitWordEsta propiedad habilita la función de confirmación automática, que se activa cuando la lista de palabras candidatas se reduce a una sola candidata.

La función de confirmación automática entra en vigor cuando la lista de palabras candidatas contiene inicialmente varias palabras y se reduce a una sola palabra tras una entrada adicional. Esta palabra se seleccionará y se confirmará automáticamente sin necesidad de intervención por parte del usuario.

Esta propiedad está configurada de forma predeterminada en « false ».

Estas propiedades se introdujeron en QtQuick.VirtualKeyboard.Settings 2.2.

Documentación de señales

userDataReset()

La aplicación activa esta señal antes de que se restablezcan los datos del usuario, con el fin de indicar al teclado virtual que debe cerrar todos los archivos del directorio de datos del usuario.

Nota: El controlador correspondiente es onUserDataReset.

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