Sur cette page

KeyboardLayout QML Type

Configuration du clavier. En savoir plus...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

ColumnLayout

Propriétés

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.