VirtualKeyboardSettings QML Type

Proporciona ajustes para el teclado virtual. Más...

• Lista de todos los miembros, incluidos los heredados

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)

Señales

• userDataReset()

Descripción detallada

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

Tenga en cuenta que los ajustes sólo tienen efecto en el tiempo de vida de la aplicación actual, es decir, los cambios de 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 idiomas activados del teclado virtual.

La lista de idiomas activados es un subconjunto de los idiomas disponibles, y puede utilizarse para limitar la lista de idiomas disponibles en el tiempo de vida de la aplicación.

La lista de idiomas se mostrará basándose en el orden especificado.

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

arrowKeyNavigationEnabled : bool [since 6.11]

Utilice 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 idiomas soportados por el teclado virtual.

Esta lista es de sólo lectura y depende de la configuración de compilación del teclado virtual.

Esta propiedad fue introducida 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 cuando se suelta la tecla Qt::Key_Enter o Qt::Key_Return. El valor por defecto es false.

Esta propiedad se introdujo en Qt 6.8.

defaultDictionaryDisabled : bool [since 6.1]

Esta propiedad desactiva el diccionario por defecto. El propósito de este ajuste es poder utilizar un diccionario personalizado únicamente 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 por defecto. El propósito de este ajuste es poder sobreescribir el método de entrada por defecto con el método de entrada simple, deshabilitando 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 replica el contenido del campo de entrada enfocado 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 fue introducida en QtQuick.VirtualKeyboard.Settings 2.2.

handwritingModeDisabled : bool [since 6.1]

Esta propiedad permite desactivar el modo de entrada de 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 de la disposición del teclado y el usuario no puede cambiar al modo de entrada de 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 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 para los idiomas chino / japonés / 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 de métodos de entrada persistentes.

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 predictivo, esta propiedad puede establecerse a Qt::ImhNoPredictiveText.

Esta propiedad se introdujo en Qt 6.1.

keySoundVolume : real [since 6.9]

Esta propiedad contiene el nivel de volumen del keysound. El nivel está en el rango [0,1].

Esta propiedad se introdujo en Qt 6.9.

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

Esta propiedad proporciona la configuración regional por defecto para el teclado.

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

Si la configuración regional del teclado es diferente de la nueva configuración regional predeterminada, el idioma del teclado se cambia inmediatamente para reflejar la nueva configuración regional. Si la configuración regional es incorrecta o no está en la lista de configuraciones regionales admitidas, se ignora y se utiliza la configuración por defecto.

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

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

styleName : string

Esta propiedad proporciona el estilo actual. La aplicación puede cambiar el estilo del teclado estableciendo un valor diferente en styleName.

El estilo de teclado de todo el sistema puede ser afectado estableciendo 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 plugins.

Por defecto, la ruta de datos de usuario se establece en GenericConfigLocation + "/qtvirtualkeyboard".

Esta propiedad se introdujo en Qt 6.1.

visibleFunctionKeys : enumeration [since 6.6]

Este parámetro ajusta la visibilidad de teclas de función específicas en la distribución del teclado, permitiendo mostrarlas u ocultarlas. Cuando una tecla de función no está visible, su funcionalidad sigue siendo accesible a través del menú de engranajes.

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 Ocultar tecla de función es visible
• QtVirtualKeyboard.KeyboardFunctionKeys.Language Tecla de función de idioma 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

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

Documentación de Señales

userDataReset()

La aplicación dispara esta señal antes de que los datos del usuario sean reiniciados para indicar al teclado virtual que todos los archivos deben ser cerrados en el directorio de datos del usuario.