VirtualKeyboardSettings QML Type

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

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

Propriétés

Signaux

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 la 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 pendant 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.


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

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

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

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


closeOnReturn : bool [since QtQuick.VirtualKeyboard.Settings 6.8]

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

Lorsque cette propriété vaut 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 QtQuick.VirtualKeyboard.Settings 6.8.


defaultDictionaryDisabled : bool [since QtQuick.VirtualKeyboard.Settings 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 QtQuick.VirtualKeyboard.Settings 6.1.


defaultInputMethodDisabled : bool [since QtQuick.VirtualKeyboard.Settings 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 de saisie par défaut par la méthode de saisie simple, en désactivant sa fonctionnalité.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Settings 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 QtQuick.VirtualKeyboard.Settings 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é est définie sur 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 QtQuick.VirtualKeyboard.Settings 6.1.


hwrTimeoutForAlphabetic : bool [since QtQuick.VirtualKeyboard.Settings 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 QtQuick.VirtualKeyboard.Settings 6.1.


hwrTimeoutForCjk : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

Cette propriété définit le délai de reconnaissance de l'écriture pour les langues chinoises / japonaises / coréennes.

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

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


inputMethodHints : int [since QtQuick.VirtualKeyboard.Settings 6.1]

Cette propriété permet de définir des indices de méthode d'entrée persistants.

La valeur de cette propriété est combinée avec les indications de méthode d'entrée du contrôle d'entrée. 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 QtQuick.VirtualKeyboard.Settings 6.1.


keySoundVolume : real [since QtQuick.VirtualKeyboard.Settings 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 QtQuick.VirtualKeyboard.Settings 6.9.


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

Cette propriété indique la locale 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 modifiée immédiatement 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é fournit le style actuel. L'application peut modifier le style du 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 QtQuick.VirtualKeyboard.Settings 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 à GenericConfigLocation + "/qtvirtualkeyboard".

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


visibleFunctionKeys : enumeration [since QtQuick.VirtualKeyboard.Settings 6.6]

Ce paramètre ajuste la visibilité de touches de fonction spécifiques dans la disposition du clavier, leur permettant d'être soit affichées, soit cachées. 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 QtQuick.VirtualKeyboard.Settings 6.6.


wordCandidateList group

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

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

Nom de la propriétéDescription de la propriété
autoHideDelayCette propriété définit le délai, en millisecondes, après lequel la liste des mots candidats est masquée si elle est vide.

Si la valeur est 0, la liste est immédiatement masquée lorsqu'elle est vide.

Si la valeur est -1, la liste est visible jusqu'à ce que le focus de saisie change ou que le panneau de saisie soit masqué.

La valeur par défaut est 5000 millisecondes.

alwaysVisibleCette propriété définit si la liste des mots candidats doit toujours rester visible.

La valeur par défaut est false.

autoCommitWordCette propriété active la fonction de validation automatique qui est activée lorsque la liste des mots candidats est réduite à un seul candidat.

La fonction de validation automatique prend effet lorsque la liste des mots candidats contient initialement plusieurs mots et qu'elle est réduite à un seul mot après une saisie supplémentaire. Ce mot sera sélectionné et validé automatiquement sans interaction de la part de l'utilisateur.

Cette propriété est définie par défaut sur false.

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


Documentation du signal

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.

Remarque : le gestionnaire correspondant est onUserDataReset.


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