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()

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

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

Die Eingabemethode kann entweder separat für jedes Tastaturlayout oder allgemein für diesen 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 allgemein 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 nutzen.

Ist die Liste leer (Standardeinstellung), 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 erstellte Eingabemethodenobjekt kann in bestimmten Fällen die Übergänge zwischen den Tastaturlayouts überdauern. Dies gilt insbesondere für die Übergänge zwischen den in der Eigenschaft sharedLayouts aufgeführten Layouts.