Sur cette page

KeyboardLayoutLoader QML Type

Permet le chargement dynamique de la disposition du clavier. Plus d'informations...

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 constituées de plusieurs pages de touches.

Une disposition de clavier unique (une page) est définie en utilisant le composant comme conteneur. La disposition de clavier active peut ensuite être modifiée en attribuant une valeur différente à 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 sur les 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 d'entrée peut être définie soit séparément pour chaque disposition de clavier, soit de manière commune 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 communément 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 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.

Documentation de la méthode

createInputMethod()

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

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.