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
- activeLocales : list<string>
(since QtQuick.VirtualKeyboard.Settings 2.0) - arrowKeyNavigationEnabled : bool
(since 6.11) - availableLocales : list<string>
(since QtQuick.VirtualKeyboard.Settings 2.0) - closeOnReturn : bool
(since 6.8) - defaultDictionaryDisabled : bool
(since 6.1) - defaultInputMethodDisabled : bool
(since 6.1) - fullScreenMode : bool
(since QtQuick.VirtualKeyboard.Settings 2.2) - handwritingModeDisabled : bool
(since 6.1) - hwrTimeoutForAlphabetic : bool
(since 6.1) - hwrTimeoutForCjk : bool
(since 6.1) - inputMethodHints : int
(since 6.1) - keySoundVolume : real
(since 6.9) - locale : string
(since QtQuick.VirtualKeyboard.Settings 2.0) - styleName : string
- userDataPath : bool
(since 6.1) - visibleFunctionKeys : enumeration
(since 6.6) - wordCandidateList
(since QtQuick.VirtualKeyboard.Settings 2.2)- wordCandidateList.alwaysVisible : bool
(since QtQuick.VirtualKeyboard.Settings 2.2) - wordCandidateList.autoHideDelay : int
(since QtQuick.VirtualKeyboard.Settings 2.2)
- wordCandidateList.alwaysVisible : bool
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.

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.NoneTodas las teclas de función están ocultasQtVirtualKeyboard.KeyboardFunctionKeys.HideLa tecla de función «Ocultar» está visibleQtVirtualKeyboard.KeyboardFunctionKeys.LanguageLa tecla de función de idioma está visibleQtVirtualKeyboard.KeyboardFunctionKeys.AllTodas 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]
| Nombre | Descripción |
|---|---|
| autoHideDelay | Esta propiedad define el retraso, en milisegundos, tras el cual se oculta la lista de palabras candidatas si está vacía. Si el valor es « Si el valor es « El valor por defecto es « |
| alwaysVisible | Esta propiedad define si la lista de palabras sugeridas debe permanecer siempre visible. El valor por defecto es |
| autoCommitWord | Esta 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 « |
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.