KeyboardLayout QML Type
Tastaturbelegung. Mehr...
| Import Statement: | import QtQuick.VirtualKeyboard.Components |
| Inherits: |
Eigenschaften
- inputMethod : var
- inputMode : int
- keyWeight : real
- sharedLayouts : var
- smallTextVisible : bool
(since QtQuick.VirtualKeyboard 2.0)
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.