VirtualKeyboardSettings QML Type

Permet de configurer le clavier virtuel. En savoir plus...

• 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 ces paramètres ne s’appliquent que pendant la durée de vie de l’application en cours ; en d’autres termes, les modifications de configuration ne sont pas permanentes.

Par exemple, pour modifier le style du clavier dans l’application :

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

Documentation des propriétés

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 s'affichera selon l'ordre spécifié.

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

arrowKeyNavigationEnabled : bool [since 6.11]

Utilisez cette propriété pour activer ou 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 la 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 compilation.

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 les touches « Qt::Key_Enter » ou « Qt::Key_Return » sont relâchées. 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. Ce paramètre permet d'utiliser exclusivement un dictionnaire personnalisé à la place 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. Ce paramètre permet de remplacer la méthode de saisie par défaut par la méthode de saisie « simple », désactivant ainsi ses fonctionnalités.

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 actif dans le champ de saisie plein écran situé en haut du clavier.

Par exemple, pour activer le mode plein écran lorsque le format d'é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 par ailleurs 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 de saisie manuscrite.

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

hwrTimeoutForAlphabetic : bool [since 6.1]

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

Par défaut, le délai d'expiration 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 d'expiration de la reconnaissance de l'écriture manuscrite pour le chinois, le japonais et le coréen.

Par défaut, le délai d'expiration 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 conseils permanents relatifs à la méthode de saisie.

La valeur de cette propriété est combinée aux indications de méthode de saisie provenant 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é contient le niveau de volume du son de la touche. Ce 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é définit les paramètres régionaux par défaut du clavier.

Lorsque aucune configuration régionale n'est spécifiée, c'est la configuration régionale par défaut du système qui est utilisée.

Si la configuration régionale du clavier diffère de la nouvelle configuration par défaut, la langue du clavier est immédiatement modifiée pour refléter la nouvelle configuration régionale. Si le paramètre de configuration régionale est incorrect ou s'il ne figure pas dans la liste des configurations régionales prises en charge, il est ignoré et le paramètre par défaut est utilisé à la place.

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

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

styleName : string

Cette propriété définit le style actuel. L'application peut modifier le style du clavier en attribuant une autre valeur à « styleName ».

Le style du clavier à l'échelle du système peut être modifié en définissant la variable d'environnement QT_VIRTUALKEYBOARD_STYLE.

userDataPath : bool [since 6.1]

Cette propriété définit le chemin d'accès aux données utilisateur pour le clavier virtuel et ses plugins.

Par défaut, le chemin d'accès aux 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 en forme de roue dentée.

La valeur peut être une combinaison des indicateurs suivants :

• QtVirtualKeyboard.KeyboardFunctionKeys.None Toutes les touches de fonction sont masqué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 afin d'indiquer au clavier virtuel que tous les fichiers du répertoire de données de l'utilisateur doivent être fermés.