Sur cette page

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 sur les propriétés

inputMethod : var

Définit la méthode de saisie à utiliser dans cette mise en page.

Cette propriété permet d'utiliser une méthode d'entrée personnalisée dans cette présentation.

inputMode : int

Définit le mode de saisie à utiliser dans cette disposition.

Par défaut, le clavier virtuel tente de préserver 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 de la clé pour toutes les clés des enfants.

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

sharedLayouts : var

Liste des noms de dispositions 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 des 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 l'objet de la méthode d'entrée de manière dynamique. L'implémentation par défaut renvoie null.

Dans certains cas, l'objet de méthode d'entrée créé par cette fonction peut survivre aux transitions entre les dispositions de clavier. Cela s'applique en particulier aux transitions entre les dispositions 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.