Virtuelle Tastatur in Qt Quick

Das Beispiel hat zwei Implementierungen: eine für Desktop-Plattformen und eine für eingebettete Plattformen. Die erste Version ermöglicht die Texteingabe in mehrere Textfelder über die virtuelle Tastatur, während die zweite Version die gleiche Benutzeroberfläche verwendet, aber mit einer eigenen virtuellen Tastatur InputPanel. Der folgende Ausschnitt aus basic.pro zeigt, wie das qmake-Projekt eingerichtet ist, um die passende Implementierung auf der Grundlage der CONFIG-Optionen auszuwählen:

!qtConfig(vkb-desktop) {
    DEFINES += MAIN_QML=\\\"basic-b2qt.qml\\\"
} else {
    DEFINES += MAIN_QML=\\\"Basic.qml\\\"
}

Das Beispiel aktiviert die virtuelle Tastatur, indem es die Umgebungsvariable QT_IM_MODULE setzt, bevor es die Datei .qml lädt:

#include <QQuickView>
#include <QGuiApplication>
#include <QQmlEngine>

int main(int argc, char *argv[])
{
    qputenv("QT_IM_MODULE", QByteArray("qtvirtualkeyboard"));

    QGuiApplication app(argc, argv);
    QQuickView view(QString("qrc:/%2").arg(MAIN_QML));
    if (view.status() == QQuickView::Error)
        return -1;
    view.setResizeMode(QQuickView::SizeRootObjectToView);

    view.show();

    return app.exec();
}

Außerdem werden die benutzerdefinierten Elemente TextField und TextArea verwendet, um das Verhalten der [ENTER]-Taste mithilfe der angehängten Eigenschaft EnterKeyAction zu konfigurieren.

import QtQuick
import QtQuick.Controls
import QtQuick.VirtualKeyboard
import "content"

Rectangle {
    ...
                TextField {
                    width: parent.width
                    placeholderText: "One line field"
                    enterKeyAction: EnterKeyAction.Next
                    onAccepted: passwordField.focus = true
                }
    ...
                TextArea {
                    id: textArea
                    width: parent.width
                    placeholderText: "Multiple line field"
                    height: Math.max(206, implicitHeight)
                }
}

Die Steuerelemente TextField und TextArea erweitern die entsprechenden Qt Quick Controls 2 Typen um die Eigenschaften enterKeyEnabled und enterKeyAction. Die Instanzen TextField und TextArea im Snippet können diese Eigenschaften festlegen, um das Standardverhalten zu ändern.

Ausführen des Beispiels

Zum Ausführen des Beispiels von Qt Creatorauszuführen, öffnen Sie den Modus Welcome und wählen Sie das Beispiel aus Examples aus. Weitere Informationen finden Sie unter Erstellen und Ausführen eines Beispiels.

Beispielprojekt @ code.qt.io