KeyboardLayout QML Type

Disposition du clavier. Plus d'informations...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

ColumnLayout

Propriétés

Méthodes

Description détaillée

Ce type est l'élément racine de la disposition de clavier. Il est utilisé pour créer une nouvelle disposition 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 des 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 disposition.


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 disposition 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 des touches pour toutes les touches enfants.

La valeur par défaut est héritée de l'élément parent dans la hiérarchie des dispositions.


sharedLayouts : var

Liste des noms de disposition qui partagent la méthode d'entrée créée par la fonction createInputMethod().

Si la liste est vide (par défaut), la méthode d'entrée n'est partagée avec aucune autre disposition et sera détruite lorsque la disposition sera modifiée.

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'adresse smallTextVisible 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 la disposition.

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


Documentation de la méthode

createInputMethod()

Cette fonction peut être surchargée par la disposition du clavier pour créer dynamiquement l'objet de la méthode d'entrée. L'implémentation par défaut renvoie null.

Dans certains cas, l'objet méthode d'entrée créé par cette fonction peut survivre aux transitions de la disposition du clavier. Cela s'applique en particulier aux transitions entre les dispositions répertoriées dans la propriété sharedLayouts.


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