KeyboardLayout QML Type
Configuration du clavier. En savoir plus...
| Import Statement: | import QtQuick.VirtualKeyboard.Components |
| Inherits: |
Propriétés
- inputMethod : var
- inputMode : int
- keyWeight : real
- sharedLayouts : var
- smallTextVisible : bool
(since QtQuick.VirtualKeyboard 2.0)
Méthodes
Description détaillée
Ce type correspond à l'élément racine de la configuration de clavier. Utilisez cet élément pour créer une nouvelle configuration de clavier.
Exemple :
import QtQuick
import QtQuick.Layouts
import QtQuick.VirtualKeyboard
// file: layouts/en_GB/main.qml
KeyboardLayout {
KeyboardRow {
Key {
key: Qt.Key_Q
text: "q"
}
Key {
key: Qt.Key_W
text: "w"
}
Key {
key: Qt.Key_E
text: "e"
}
Key {
key: Qt.Key_R
text: "r"
}
Key {
key: Qt.Key_T
text: "t"
}
Key {
key: Qt.Key_Y
text: "y"
}
}
}Documentation sur les propriétés
inputMethod : var
Définit la méthode de saisie à utiliser dans cette disposition.
Cette propriété permet d'utiliser une méthode de saisie personnalisée dans cette mise en page.
inputMode : int
Définit le mode de saisie à utiliser dans cette disposition.
Par défaut, le clavier virtuel tente de conserver le mode de saisie actuel lors du passage à une autre configuration de clavier.
Si le mode de saisie actuel n'est pas valide dans le contexte actuel, le mode de saisie par défaut est spécifié par la méthode de saisie.
keyWeight : real
Définit le poids de toutes les clés enfants.
La valeur par défaut est héritée de l'élément parent dans la hiérarchie de mise en page.
sharedLayouts : var
Liste des noms de dispositions qui partagent la méthode de saisie créée par la fonction createInputMethod().
Si la liste est vide (valeur par défaut), la méthode de saisie n’est partagée avec aucune autre disposition et sera détruite lorsque la disposition changera.
La liste ne doit contenir que le nom du type de disposition, par exemple ['symbols']. La disposition actuelle n'a pas besoin d'être incluse dans la liste.
smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]
Définit l'smallTextVisible e pour toutes les clés enfants.
La valeur par défaut est héritée de l'élément parent dans la hiérarchie de mise en page.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.0.
Documentation des méthodes
createInputMethod()
Cette fonction peut être redéfinie par la configuration du clavier afin de créer dynamiquement l'objet de méthode de saisie. L'implémentation par défaut renvoie ` null`.
L'objet de méthode de saisie créé par cette fonction peut, dans certains cas, survivre aux transitions de configuration de clavier. Cela s'applique notamment aux transitions entre les configurations répertoriées dans la propriété sharedLayouts.
© 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.