KeyboardLayoutLoader QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• inputMethod : var
• inputMode : int
• sharedLayouts : var

Methoden

• createInputMethod()

Ausführliche Beschreibung

Dieser Typ eignet sich 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
        }
    }
}

Dokumentation zu den Eigenschaften

inputMethod : var

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

Die Eingabemethode kann entweder für jedes Tastaturlayout separat oder allgemein für diesen Kontext festgelegt werden. Bei separater Festlegung 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 für jedes Tastaturlayout separat oder allgemein für diesen Kontext festgelegt werden. Bei separater Festlegung sollte diese Eigenschaft nicht geändert werden.

sharedLayouts : var

Liste der Layoutnamen, die sich die von der Funktion „ createInputMethod()“ erstellte Eingabemethode teilen.

Ist die Liste leer (Standard), wird die Eingabemethode nicht mit anderen Layouts geteilt und bei einem Layoutwechsel gelöscht.

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

Methodendokumentation

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 erstellte Eingabemethodenobjekt kann in bestimmten Fällen länger bestehen bleiben als die Wechsel zwischen Tastaturlayouts. Dies gilt insbesondere für die Wechsel zwischen den Layouts, die in der Eigenschaft „ sharedLayouts “ aufgeführt sind.