KeyboardLayoutLoader QML Type

Ermöglicht das dynamische Laden des Tastaturlayouts. Mehr...

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

Loader

Eigenschaften

Methoden

Detaillierte Beschreibung

Dieser Typ ist nützlich für Tastaturlayouts, die aus mehreren Seiten mit Tasten bestehen.

Ein einzelnes Tastaturlayout (eine Seite) wird definiert, indem die Komponente als Container verwendet wird. Das aktive Tastaturlayout kann dann geändert werden, indem die Eigenschaft sourceComponent auf einen anderen Wert gesetzt wird.

Beispiel:

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
        }
    }
}

Eigenschaft Dokumentation

inputMethod : var

Setzt die Eingabemethode für alle in diesem Kontext geladenen Tastaturlayouts.

Die Eingabemethode kann entweder separat für jedes Tastaturlayout oder gemeinsam in diesem Kontext festgelegt werden. Wenn sie separat festgelegt wird, sollte diese Eigenschaft nicht geändert werden.


inputMode : int

Legt den Eingabemodus für alle in diesem Kontext geladenen Tastaturlayouts fest.

Der Eingabemodus kann entweder separat für jedes Tastaturlayout oder gemeinsam für diesen Kontext festgelegt werden. Wenn er separat eingestellt wird, sollte diese Eigenschaft nicht geändert werden.


sharedLayouts : var

Liste der Layoutnamen, die die mit der Funktion createInputMethod() erstellte Eingabemethode gemeinsam haben.

Wenn die Liste leer ist (Standard), wird die Eingabemethode mit keinem anderen Layout geteilt und wird zerstört, wenn das Layout geändert wird.

Die Liste sollte nur den Namen des Layouttyps enthalten, z. B. ['symbols']. Das aktuelle Layout muss nicht in der Liste enthalten sein.


Dokumentation der Methode

createInputMethod()

Diese Funktion kann vom Tastaturlayout überschrieben werden, um das Eingabemethodenobjekt dynamisch zu erstellen. Die Standardimplementierung leitet den Aufruf an das untergeordnete Tastaturlayout weiter.

Das durch diese Funktion erzeugte Eingabemethodenobjekt kann in bestimmten Fällen Tastaturlayoutübergänge überdauern. Dies gilt insbesondere für die Übergänge zwischen den in der Eigenschaft sharedLayouts aufgeführten Layouts.


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