Back to Qt.io
Contact Us Blog Download Qt

KeyboardLayout QML Type

Tastatur-Layout. Mehr...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

ColumnLayout

Eigenschaften

Methoden

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 Layouthierarchie geerbt.


sharedLayouts : var

Liste der Layoutnamen, die die mit der Funktion createInputMethod() erstellte Eingabemethode gemeinsam haben.

Ist die Liste leer (Standardwert), wird die Eingabemethode mit keinem anderen Layout geteilt und bei einer Änderung des Layouts zerstört.

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]

Setzt die smallTextVisible für alle untergeordneten Schlüssel.

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 vom Tastaturlayout überschrieben werden, um das Eingabemethodenobjekt dynamisch zu erstellen. Die Standardimplementierung gibt null zurück.

Das von dieser Funktion erzeugte 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.


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