VirtualKeyboardSettings QML Type

Fournit des paramètres pour le clavier virtuel. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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)

Signaux

• userDataReset()

Description détaillée

Ce type fournit une instance singleton de VirtualKeyboardSettings, qui peut être utilisée pour configurer les paramètres du clavier virtuel.

Veuillez noter que les paramètres n'ont d'effet que pendant la durée de vie de l'application en cours, c'est-à-dire que les changements de configuration ne sont pas permanents.

Par exemple, pour changer le style de clavier dans l'application :

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

Propriété Documentation

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

Cette propriété contient une liste des langues activées du clavier virtuel.

La liste des langues actives est un sous-ensemble des langues disponibles et peut être utilisée pour limiter la liste des langues disponibles dans la durée de vie de l'application.

La liste des langues sera affichée en fonction de l'ordre spécifié.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Settings 2.0.

arrowKeyNavigationEnabled : bool [since 6.11]

Cette propriété permet d'activer ou de désactiver la navigation à l'aide des touches fléchées.

Cette propriété a été introduite dans Qt 6.11.

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

Cette propriété contient une liste des langues prises en charge par le clavier virtuel.

Cette liste est en lecture seule et dépend de la configuration du clavier virtuel au moment de la construction.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Settings 2.0.

closeOnReturn : bool [since 6.8]

Cette propriété permet de masquer le clavier virtuel.

Lorsque cette propriété est définie sur true, le clavier virtuel est masqué lorsque la touche Qt::Key_Enter ou Qt::Key_Return est relâchée. La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.8.

defaultDictionaryDisabled : bool [since 6.1]

Cette propriété désactive le dictionnaire par défaut. L'objectif de ce paramètre est de pouvoir utiliser un dictionnaire personnalisé uniquement au lieu du dictionnaire standard.

Cette propriété a été introduite dans Qt 6.1.

defaultInputMethodDisabled : bool [since 6.1]

Cette propriété désactive la méthode de saisie par défaut. L'objectif de ce paramètre est de pouvoir remplacer la méthode d'entrée par défaut par la méthode d'entrée simple, en désactivant sa fonctionnalité.

Cette propriété a été introduite dans Qt 6.1.

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

Cette propriété active le mode plein écran pour le clavier virtuel.

En mode plein écran, le clavier virtuel reproduit le contenu du champ de saisie focalisé dans le champ de saisie plein écran situé en haut du clavier.

Par exemple, pour activer le mode plein écran lorsque le format de l'écran est supérieur à 16:9 :

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

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Settings 2.2.

handwritingModeDisabled : bool [since 6.1]

Cette propriété permet de désactiver le mode de saisie manuscrite, s'il est disponible dans le système.

Lorsque cette propriété vaut true, le bouton d'écriture manuscrite est masqué dans la disposition du clavier et l'utilisateur ne peut pas passer en mode d'écriture manuscrite.

Cette propriété a été introduite dans Qt 6.1.

hwrTimeoutForAlphabetic : bool [since 6.1]

Cette propriété définit le délai de reconnaissance de l'écriture manuscrite pour les langues alphabétiques.

Par défaut, le délai est de 500 millisecondes.

Cette propriété a été introduite dans Qt 6.1.

hwrTimeoutForCjk : bool [since 6.1]

Cette propriété définit le délai de reconnaissance de l'écriture manuscrite pour les langues chinoise / japonaise / coréenne.

Par défaut, le délai est de 500 millisecondes.

Cette propriété a été introduite dans Qt 6.1.

inputMethodHints : int [since 6.1]

Cette propriété permet de définir des indications persistantes sur les méthodes d'entrée.

La valeur de cette propriété est combinée avec les indications de méthode de saisie du contrôle de saisie. Par exemple, pour désactiver la saisie de texte prédictive, cette propriété peut être définie sur Qt::ImhNoPredictiveText.

Cette propriété a été introduite dans Qt 6.1.

keySoundVolume : real [since 6.9]

Cette propriété indique le niveau de volume du son du clavier. Le niveau est compris dans l'intervalle [0,1]

Cette propriété a été introduite dans Qt 6.9.

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

Cette propriété indique les paramètres linguistiques par défaut du clavier.

Si la locale n'est pas spécifiée, la locale par défaut du système est utilisée à la place.

Si la locale du clavier est différente de la nouvelle locale par défaut, la langue du clavier est immédiatement modifiée pour refléter la nouvelle locale. Si les paramètres régionaux sont incorrects ou s'ils ne figurent pas dans la liste des paramètres régionaux pris en charge, ils sont ignorés et les paramètres par défaut sont utilisés à la place.

Une locale est prise en charge si elle figure dans la liste des availableLocales.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Settings 2.0.

styleName : string

Cette propriété indique le style actuel. L'application peut modifier le style de clavier en attribuant une valeur différente à styleName.

Le style de clavier du système peut être affecté en définissant la variable d'environnement QT_VIRTUALKEYBOARD_STYLE.

userDataPath : bool [since 6.1]

Cette propriété définit le chemin des données utilisateur pour le clavier virtuel et ses plugins.

Par défaut, le chemin des données utilisateur est défini sur GenericConfigLocation + "/qtvirtualkeyboard".

Cette propriété a été introduite dans Qt 6.1.

visibleFunctionKeys : enumeration [since 6.6]

Ce paramètre permet de régler la visibilité de certaines touches de fonction dans la disposition du clavier, en les affichant ou en les masquant. Lorsqu'une touche de fonction n'est pas visible, sa fonctionnalité reste accessible via le menu d'engrenage.

La valeur peut être une combinaison des drapeaux suivants :

• QtVirtualKeyboard.KeyboardFunctionKeys.None Toutes les touches de fonction sont cachées
• QtVirtualKeyboard.KeyboardFunctionKeys.Hide La touche de fonction Masquer est visible
• QtVirtualKeyboard.KeyboardFunctionKeys.Language La touche de fonction Langue est visible
• QtVirtualKeyboard.KeyboardFunctionKeys.All Toutes les touches de fonction sont visibles

La valeur par défaut est QtVirtualKeyboard.KeyboardFunctionKeys.All.

Cette propriété a été introduite dans Qt 6.6.

wordCandidateList group

Ces propriétés ont été introduites dans QtQuick.VirtualKeyboard.Settings 2.2.

Documentation sur les signaux

userDataReset()

L'application déclenche ce signal avant la réinitialisation des données de l'utilisateur pour indiquer au clavier virtuel que tous les fichiers doivent être fermés dans le répertoire des données de l'utilisateur.