Qt Quick Controls
Qt Quick Controls wird eine Reihe von Steuerelementen bereitgestellt, mit denen sich vollständige Benutzeroberflächen in „ Qt Quick “ erstellen lassen.
Qt Quick Controls Es stehen verschiedene anpassbare Stile zur Auswahl. Weitere Informationen finden Sie unter „Gestaltung von Qt Quick Controls “.
Verwendung des Moduls
QML-API
Die QML-Typen des Moduls sind über den Import „ QtQuick.Controls “ verfügbar. Um die Typen zu verwenden, fügen Sie die folgende Importanweisung in Ihre .qml-Datei ein:
import QtQuick.ControlsC++-API
Die Verwendung der C++-API eines Qt-Moduls erfordert die 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.
Erstellen 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 Informationen finden Sie in der Übersicht „Erstellen mit CMake “.
Erstellen mit qmake
Um das Modul für die Erstellung mit qmake zu konfigurieren, fügen Sie das Modul als Wert der Variablen ` QT ` in der `.pro`-Datei des Projekts hinzu:
QT += quickcontrols2Erstellen aus dem Quellcode
Die Qt Image Formats Modul wird empfohlen, ist jedoch nicht zwingend erforderlich. Es bietet Unterstützung für das vom „Imagine“-Stil verwendete „ .webp “-Format.
Steuerelemente
Eine vollständige Liste der „ Qt Quick Controls “-Optionen finden Sie unter QML Types.
Schaltflächen-Steuerelemente
Abstrakter Basistyp, der die für Schaltflächen typische Funktionalität bereitstellt | |
Drucktaste, die angeklickt werden kann, um einen Befehl auszuführen oder eine Frage zu beantworten | |
Kontrollkästchen, das ein- oder ausgeschaltet werden kann | |
Kontrollkästchen, das ausgelöst wird, wenn es lange genug gedrückt gehalten wird | |
Exklusives Optionsfeld, das ein- oder ausgeschaltet werden kann | |
Ein Drucktasten-Steuerelement mit abgerundeten Ecken, auf das der Benutzer klicken kann | |
Schaltfläche, die ein- oder ausgeschaltet werden kann | |
Schaltfläche mit einem für eine Symbolleiste geeigneten Erscheinungsbild |
Container-Steuerelemente
Gestaltetes Fenster der obersten Ebene mit Unterstützung für Kopf- und Fußzeile | |
Abstrakter Basistyp, der die für Container gemeinsamen Funktionen bereitstellt | |
Visueller Rahmen für eine logische Gruppe von Steuerelementen | |
Visueller Rahmen und Titel für eine logische Gruppe von Steuerelementen | |
Stellt eine horizontale Kopfzeilenansicht als Ergänzung zu einer TableView bereit | |
Gestaltetes Seitensteuerelement mit Unterstützung für Kopf- und Fußzeile | |
Stellt einen Hintergrund bereit, der zum Anwendungsstil und -design passt | |
Scrollbare Ansicht | |
Ordnet Elemente mit einem verschiebbaren Trennbalken zwischen den einzelnen Elementen an | |
Bietet ein stapelbasiertes Navigationsmodell | |
Ermöglicht dem Benutzer die Navigation durch Seiten durch seitliches Wischen | |
Ermöglicht dem Benutzer das Wechseln zwischen verschiedenen Ansichten oder Teilaufgaben | |
Container für kontextsensitive Steuerelemente | |
Bietet eine vertikale Kopfzeilenansicht als Ergänzung zu einer TableView |
Delegat-Steuerelemente
Element-Delegat mit einem Kontrollkästchen, das ein- und ausgeschaltet werden kann | |
Einfacher Element-Delegat, der in verschiedenen Ansichten und Steuerelementen verwendet werden kann | |
Exklusiver Element-Delegat mit einem Radio-Anzeiger, der ein- oder ausgeschaltet werden kann | |
Wischbarer Element-Delegat | |
Element-Delegat mit einem Schalter-Symbol, das ein- und ausgeschaltet werden kann | |
Ein Delegat, der einer TableView zugewiesen werden kann | |
Ein Delegat, der einer TreeView zugewiesen werden kann | |
Anzeigesteuerelemente
Zeigt Hintergrundaktivitäten an, beispielsweise während Inhalte geladen werden | |
Zeigt die aktuell aktive Seite an | |
Zeigt den Fortschritt eines Vorgangs an | |
Vertikale oder horizontale interaktive Bildlaufleiste | |
Vertikaler oder horizontaler nicht-interaktiver Bildlaufindikator |
Eingabesteuerelemente
Kombination aus Schaltfläche und Popup-Liste zur Auswahl von Optionen | |
Drehregler, der zum Einstellen eines Werts gedreht wird | |
Ermöglicht dem Benutzer die Auswahl aus einer Reihe voreingestellter Gleitkommawerte | |
Dient zur Auswahl eines Wertebereichs durch Verschieben zweier Schieberegler entlang einer Schiene | |
Ein spezielles Eingabefeld, das für Suchfunktionen vorgesehen ist | |
Dient zur Auswahl eines Werts durch Verschieben eines Schiebereglers entlang einer Skala | |
Ermöglicht dem Benutzer die Auswahl aus einer Reihe voreingestellter Werte | |
Mehrzeiliges Texteingabefeld | |
Einzeiliges Texteingabefeld | |
Drehbares Rad mit auswählbaren Elementen |
Menüsteuerelemente
Der Typ „Attached“ bietet die Möglichkeit, ein Kontextmenü plattformgerecht zu öffnen | |
Popup, das als Kontextmenü oder Popup-Menü verwendet werden kann | |
Stellt eine Fenster-Menüleiste bereit | |
Zeigt ein Dropdown-Menü innerhalb einer Menüleiste an | |
Zeigt einen Eintrag innerhalb eines Menüs an |
Navigationselemente
Seitenleiste, die durch eine Wischgeste geöffnet und geschlossen werden kann | |
Bietet ein stapelbasiertes Navigationsmodell | |
Ermöglicht dem Benutzer die Navigation zwischen Seiten durch seitliches Wischen | |
Ermöglicht dem Benutzer das Wechseln zwischen verschiedenen Ansichten oder Teilaufgaben | |
Schaltfläche mit einem für eine TabBar geeigneten Design |
Popup-Steuerelemente
Popup-Dialogfeld mit Standardschaltflächen und einem Titel, das für kurzfristige Interaktionen mit dem Benutzer verwendet wird | |
Seitenleiste, die durch eine Wischgeste geöffnet und geschlossen werden kann | |
Popup, das als Kontextmenü oder Popup-Menü verwendet werden kann | |
Basistyp für Popup-ähnliche Benutzeroberflächen-Steuerelemente | |
Stellt Tooltips für jedes Steuerelement bereit |
Trennsteuerelemente
Trennt eine Gruppe von Elementen in einem Menü von benachbarten Elementen | |
Trennt eine Gruppe von Elementen in einer Symbolleiste von benachbarten Elementen |
Entwicklung des Moduls
Qt Quick Controls wurde ursprünglich mit dem Schwerpunkt auf Touch-Oberflächen entwickelt. Zwar ist es bereits möglich, Desktop-Oberflächen zu entwickeln, doch wird weiterhin daran gearbeitet, ein noch authentischeres Erscheinungsbild und Bediengefühl zu erzielen.
Änderungen an Qt Quick Controls listen wichtige Änderungen an der Modul-API und der Funktionalität auf, die für die Qt-6-Serie von Qt vorgenommen wurden.
Das Versionsschema beschreibt das für „ Qt Quick Controls “ verwendete Versionsschema.
Artikel und Anleitungen
- Erste Schritte
- Richtlinien
- Gestaltung
- Symbole
- Anpassung
- Verwendung von Dateiauswahlfeldern
- Bereitstellung
- Konfigurationsdatei
- Umgebungsvariablen
Beispiele
Referenz
Verwandte Module
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, verfügbar. Weitere Informationen finden Sie unter Qt-Lizenzierung.
Darüber hinaus enthält „ Qt Quick Controls “ möglicherweise Module von Drittanbietern unter den folgenden freizügigen Lizenzen:
MIT-Lizenz |
© 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.
