KeyboardLayout QML Type

Tastatur-Layout. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• inputMethod : var
• inputMode : int
• keyWeight : real
• sharedLayouts : var
• smallTextVisible : bool (since QtQuick.VirtualKeyboard 2.0)

Methoden

• createInputMethod()

Detaillierte Beschreibung

Dieser Typ ist das Wurzelelement des Tastaturlayouts. Verwenden Sie dieses Element, um ein neues Tastaturlayout zu erstellen.

Beispiel:

import QtQuick
import QtQuick.Layouts
import QtQuick.VirtualKeyboard

// file: layouts/en_GB/main.qml

KeyboardLayout {
    KeyboardRow {
        Key {
            key: Qt.Key_Q
            text: "q"
        }
        Key {
            key: Qt.Key_W
            text: "w"
        }
        Key {
            key: Qt.Key_E
            text: "e"
        }
        Key {
            key: Qt.Key_R
            text: "r"
        }
        Key {
            key: Qt.Key_T
            text: "t"
        }
        Key {
            key: Qt.Key_Y
            text: "y"
        }
    }
}

Eigenschaft Dokumentation

inputMethod : var

Legt die Eingabemethode fest, die in diesem Layout verwendet werden soll.

Mit dieser Eigenschaft kann eine benutzerdefinierte Eingabemethode in diesem Layout verwendet werden.

inputMode : int

Legt den Eingabemodus fest, der in diesem Layout verwendet werden soll.

Standardmäßig versucht die virtuelle Tastatur, den aktuellen Eingabemodus beizubehalten, wenn sie zu einem anderen Tastaturlayout wechselt.

Wenn der aktuelle Eingabemodus im aktuellen Kontext nicht gültig ist, wird der Standard-Eingabemodus durch die Eingabemethode festgelegt.

keyWeight : real

Legt die Tastengewichtung für alle untergeordneten Tasten fest.

Der Standardwert wird vom übergeordneten Element in der Layout-Hierarchie geerbt.

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.

smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

Legt die smallTextVisible für alle untergeordneten Schlüssel fest.

Der Standardwert wird vom übergeordneten Element in der Layouthierarchie geerbt.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.

Dokumentation der Methode

createInputMethod()

Diese Funktion kann durch das Tastaturlayout überschrieben werden, um das Eingabemethodenobjekt dynamisch zu erstellen. Die Standardimplementierung gibt null zurück.

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