Qt Quick Controls

Qt Quick Controls stellt eine Reihe von Steuerelementen zur Verfügung, die zur Erstellung kompletter Oberflächen in Qt Quick verwendet werden können. Das Modul wurde in Qt 5.7 eingeführt.

Qt Quick Controls wird mit einer Auswahl von anpassbaren Stilen geliefert. Siehe Styling Qt Quick Controls für weitere Details.

Verwendung des Moduls

QML-API

Die QML-Typen des Moduls sind über den QtQuick.Controls -Import verfügbar. Um die Typen zu verwenden, fügen Sie die folgende Importanweisung in Ihre .qml-Datei ein:

import QtQuick.Controls

C++-API

Die Verwendung der C++-API eines Qt-Moduls erfordert eine Verknüpfung mit der Modulbibliothek, entweder direkt oder über andere Abhängigkeiten. Mehrere Build-Tools bieten hierfür spezielle Unterstützung, darunter CMake und qmake.

Bauen mit CMake

Verwenden Sie den Befehl find_package(), um die benötigte Modulkomponente im Paket Qt6 zu finden:

find_package(Qt6 REQUIRED COMPONENTS QuickControls2)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)

Weitere Einzelheiten finden Sie in der Übersicht Bauen mit CMake.

Bauen mit qmake

Um das Modul für die Erstellung mit qmake zu konfigurieren, fügen Sie das Modul als Wert der Variable QT in der .pro-Datei des Projekts hinzu:

QT += quickcontrols2

Bauen aus dem Quellcode

Das Qt Image Formats Modul wird empfohlen, ist aber nicht erforderlich. Es bietet Unterstützung für das Format .webp, das vom Imagine-Stil verwendet wird.

Steuerelemente

Die vollständige Liste von Qt Quick Controls finden Sie unter QML Types.

Tasten-Bedienelemente

Container-Steuerelemente

Delegierte Steuerelemente

Indikator-Steuerelemente

Eingabe-Steuerelemente

Menü-Steuerelemente

Navigations-Steuerelemente

Popup-Steuerelemente

Separator-Steuerelemente

Versionen

Qt Quick Controls 2.0 wurde in Qt 5.7 eingeführt. Nachfolgende Qt-Nebenversionen erhöhen die Importversion der Qt Quick Controls -Module um eins, bis Qt 5.12, wo die Importversionen mit der Nebenversion von Qt übereinstimmen.

In Qt 6 stimmen sowohl die Haupt- als auch die Nebenversion überein, und die Versionsnummern können bei Importen in QML weggelassen werden. Wenn die Version weggelassen wird, wird die neueste Version verwendet.

Die experimentellen Qt Labs Module verwenden die Importversion 1.0.

Überarbeitungen

Aufgrund der Art und Weise, wie Qt Quick Controls implementiert ist, können neue Eigenschaften, die hinzugefügt werden, mit benutzerdefinierten Eigenschaften desselben Namens kollidieren. Der folgende Ausschnitt führt zum Beispiel zu einem Fehler:

import QtQuick.Controls 2.13

ApplicationWindow {
    // ...

    ComboBox {
        anchors.centerIn: parent

        // As currentValue was added in 2.14, the versioned import above
        // should cause this property to be used, but instead an error is produced:
        // "Cannot override FINAL property"
        property int currentValue: 0
    }
}

Diese Eigenschaften sollten umbenannt werden, um den Konflikt zu vermeiden.

Das Modul Evolution

Qt Quick Controls wurde ursprünglich mit dem Schwerpunkt auf Touch-Oberflächen geschrieben. Es ist zwar bereits möglich, Desktop-Oberflächen zu entwickeln, aber es wird weiter daran gearbeitet, ein nativeres Aussehen und Gefühl zu vermitteln.

Änderungen an Qt Quick Controls listet wichtige Änderungen an der Modul-API und der Funktionalität auf, die für die Qt 6-Serie von Qt vorgenommen wurden.

Artikel und Leitfäden

• Erste Anfänge
• Richtlinien
• Gestalten
• Icons
• Anpassung
• Dateiselektoren verwenden
• Bereitstellung
• Konfigurationsdatei
• Umgebungsvariablen

Beispiele

• Galerie
• Chat-Tutorial
• Text-Editor
• Wearable Demo
• Automobil Beispiel
• Alle Beispiele

Referenz

• QML Types
• C++ Classes

Verwandte Module

• Qt Quick
• Qt Quick Layouts
• Qt Quick Schablonen 2
• Qt Labs Platform

Lizenz und Namensnennung

Qt Quick Controls ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter der GNU Lesser General Public License, Version 3, oder der GNU General Public License, Version 2, erhältlich. Siehe Qt-Lizenzierung für weitere Details.

Darüber hinaus enthält Qt Quick Controls möglicherweise Module von Drittanbietern, die den folgenden Lizenzen unterliegen: