Sur cette page

KeyboardLayoutLoader QML Type

Permet le chargement dynamique de la configuration du clavier. En savoir plus...

Import Statement: import QtQuick.VirtualKeyboard.Components
Since: QtQuick.VirtualKeyboard 1.1
Inherits:

Loader

Propriétés

Méthodes

Description détaillée

Ce type est utile pour les dispositions de clavier composées de plusieurs pages de touches.

Une disposition de clavier (une page) est définie en utilisant le composant comme conteneur. La disposition de clavier active peut ensuite être modifiée en attribuant une autre valeur à la propriété sourceComponent.

Exemple :

import QtQuick
import QtQuick.Layouts
import QtQuick.VirtualKeyboard

// file: layouts/en_GB/symbols.qml

KeyboardLayoutLoader {
    property bool secondPage
    onVisibleChanged: if (!visible) secondPage = false
    sourceComponent: secondPage ? page2 : page1
    Component {
        id: page1
        KeyboardLayout {
            // Keyboard layout definition for page 1
        }
    }
    Component {
        id: page2
        KeyboardLayout {
            // Keyboard layout definition for page 2
        }
    }
}

Documentation des propriétés

inputMethod : var

Définit la méthode de saisie pour toutes les dispositions de clavier chargées dans ce contexte.

La méthode de saisie peut être définie soit séparément pour chaque disposition de clavier, soit de manière globale dans ce contexte. Si elle est définie séparément, cette propriété ne doit pas être modifiée.

inputMode : int

Définit le mode de saisie pour toutes les dispositions de clavier chargées dans ce contexte.

Le mode de saisie peut être défini soit séparément pour chaque disposition de clavier, soit de manière globale dans ce contexte. S'il est défini séparément, cette propriété ne doit pas être modifiée.

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.

Documentation de la méthode

createInputMethod()

Cette fonction peut être redéfinie par la configuration de clavier afin de créer dynamiquement l’objet de méthode de saisie. L’implémentation par défaut transfère l’appel à la configuration de clavier enfant.

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.