Auf dieser Seite

KeyboardLayout QML Type

Tastaturbelegung. Mehr...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

ColumnLayout

Eigenschaften

Methoden

Ausführliche Beschreibung

Dieser Typ ist das Stammelement 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"
        }
    }
}

Dokumentation zu den Eigenschaften

inputMethod : var

Legt die in diesem Layout zu verwendende Eingabemethode fest.

Diese Eigenschaft ermöglicht die Verwendung einer benutzerdefinierten Eingabemethode in diesem Layout.

inputMode : int

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

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

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

keyWeight : real

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

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

sharedLayouts : var

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

Ist die Liste leer (Standardeinstellung), 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 aufgeführt sein.

smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

Legt den Wert „ smallTextVisible “ für alle untergeordneten Schlüssel fest.

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

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

Methodendokumentation

createInputMethod()

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

Das durch diese Funktion erstellte Eingabemethodenobjekt kann in bestimmten Fällen länger bestehen bleiben als Tastaturlayout-Wechsel. Dies gilt insbesondere für die Wechsel zwischen den Layouts, die in der Eigenschaft „ sharedLayouts “ aufgeführt sind.

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