Qt Quick Controls Konfigurationsdatei
Qt Quick Controls unterstützen eine spezielle Konfigurationsdatei, qtquickcontrols2.conf, die in die Ressourcen einer Anwendung integriert wird.
In der Konfigurationsdatei können der bevorzugte Stil und bestimmte stilspezifische Attribute angegeben werden. Im folgenden Beispiel wird festgelegt, dass der bevorzugte Stil der Stil Material ist. Wenn die Anwendung mit dem Stil Material ausgeführt wird, ist das Thema hell und die Akzent- und Primärfarben sind teal bzw. blue grey. Wird die Anwendung stattdessen mit dem Stil Universal ausgeführt, ist die Akzentfarbe rot und das entsprechende Design wird auf der Grundlage der Systemdesignfarben ausgewählt.
[Controls] Style=Material [Universal] Theme=System Accent=Red [Material] Theme=Light Accent=Teal Primary=BlueGrey
Es ist möglich, mit der Umgebungsvariablen QT_QUICK_CONTROLS_CONF einen eigenen Speicherort für die Konfigurationsdatei anzugeben.
Abschnitt "Steuerelemente
Die folgenden Werte können in einem Controls Abschnitt der Konfigurationsdatei angegeben werden:
| Variable | Beschreibung |
|---|---|
Style | Gibt den Stil an, mit dem die Anwendung ausgeführt werden soll. Der Wert kann der Name eines der integrierten Stile oder ein benutzerdefinierter Stil sein. |
FallbackStyle | Gibt den Stil an, der für Steuerelemente verwendet werden soll, die nicht implementiert sind. Der Stil muss einer der eingebauten Stile sein. Standardmäßig wird der Stil Basic verwendet. |
Abschnitt Imagine
In der folgenden Tabelle sind die Werte aufgeführt, die zur Konfiguration des Stils Imagine in einem Abschnitt Imagine der Konfigurationsdatei verwendet werden können:
| Variable | Beschreibung |
|---|---|
Path | Gibt den Pfad zum Verzeichnis an, das die Imagine-Assets enthält. Wenn kein Pfad angegeben wird, werden die eingebauten Elemente verwendet. Zum Beispiel, um einen Pfad zu einem Verzeichnis anzugeben, das im Ressourcensystem gespeichert ist: [Imagine] Path=:/imagine-assets So geben Sie einen relativen Pfad zu einem lokalen Verzeichnis an: [Imagine] Path=imagine-assets Hinweis: Aufgrund einer technischen Einschränkung sollte der Pfad nicht "imagine" heißen, wenn er relativ zur Datei |
Abschnitt "Material
In der folgenden Tabelle sind Werte aufgeführt, die zur Konfiguration des Materialstils in einem Abschnitt Material der Konfigurationsdatei verwendet werden können:
| Variable | Beschreibung |
|---|---|
Theme | Legt das Standard-Materialthema fest. Der Wert kann eines der verfügbaren Designs sein, zum Beispiel "Dark". |
Variant | Legt die Material-Variante fest. Das Material Design hat zwei Varianten: eine normale Variante, die für Touch-Geräte entwickelt wurde, und eine dichte Variante für den Desktop. Bei der dichten Variante werden kleinere Größen für Steuerelemente und deren Schriftarten verwendet. Der Wert kann |
Accent | Legt die standardmäßige Materialakzentfarbe fest. Der Wert kann ein beliebiger color sein, es wird jedoch empfohlen, eine der vordefinierten Materialfarben zu verwenden, zum Beispiel "Teal". |
Primary | Legt die Standard-Grundfarbe von Material fest. Der Wert kann ein beliebiger color sein, aber es wird empfohlen, eine der vordefinierten Materialfarben zu verwenden, z. B. "BlueGrey". |
Foreground | Legt die Standard-Vordergrundfarbe von Material fest. Der Wert kann eine beliebige color oder eine der vordefinierten Materialfarben sein, z. B. "Brown". |
Background | Legt die Standard-Hintergrundfarbe von Material fest. Der Wert kann eine beliebige color oder eine der vordefinierten Materialfarben sein, z. B. "Grey". |
Universeller Abschnitt
In der folgenden Tabelle sind die Werte aufgeführt, die zur Konfiguration des Stils Universal in einem Abschnitt Universal der Konfigurationsdatei verwendet werden können:
| Variable | Beschreibung |
|---|---|
Theme | Legt das Standard-Universal-Theme fest. Der Wert kann eines der verfügbaren Designs sein, zum Beispiel "Dark". |
Accent | Legt die Standard-Universal-Akzentfarbe fest. Der Wert kann eine beliebige color sein, es wird jedoch empfohlen, eine der vordefinierten Universal-Farben zu verwenden, z. B. "Violet". |
Foreground | Legt die standardmäßige Universal-Vordergrundfarbe fest. Der Wert kann eine beliebige color oder eine der vordefinierten Universal-Farben sein, z. B. "Brown". |
Background | Legt die Standard-Universal-Hintergrundfarbe fest. Der Wert kann eine beliebige color oder eine der vordefinierten Universal-Farben sein, z. B. "Steel". |
Schriftart-Konfiguration
Die Standardschrift font kann in einer Untergruppe Font im Abschnitt jedes Stils in der Konfigurationsdatei angegeben werden:
[Basic] Font\Family=Open Sans Font\PixelSize=20
Unterstützte Schriftattribute:
| Variable | Beschreibung |
|---|---|
Family | Die font family. |
PointSize | Die point size. |
PixelSize | Die pixel size. |
StyleHint | Die style hint. Verfügbare Werte: SansSerif, Helvetica, Serif, Times, TypeWriter, Courier, OldEnglish, Decorative, Monospace, Fantasy, Cursive. |
Weight | Die weight. Qt verwendet eine Gewichtungsskala von 1 bis 1000, die mit OpenType kompatibel ist. Eine Gewichtung von 1 wird dünn sein, während 1000 extrem schwarz sein wird. Verfügbare vordefinierte Gewichte: Thin (100), ExtraLight (200), Light (300), Normal (400), Medium (500), DemiBold (600), Bold (700), ExtraBold (800), Black (900). |
Style | Die style. Verfügbare Werte: StyleNormal, StyleItalic, StyleOblique. |
Konfiguration der Palette
Die Standardpalette palette kann für jeden Stil mithilfe der Untergruppe Palette in der Konfigurationsdatei konfiguriert werden. Die Untergruppe Palette kann auf zwei verschiedene Arten definiert werden:
[Fusion] Palette\Window=#dedede Palette\WindowText=#212121
Siehe Palette QML-Typ für weitere Informationen.
Verwendung der Konfigurationsdatei in einem Projekt
Damit Qt Quick Controls die Konfigurationsdatei finden kann, muss sie mit Hilfe des Qt Resource Systems in die Ressourcen der Anwendung eingebaut werden. Hier ist ein Beispiel für eine .qrc Datei:
<!DOCTYPE RCC><RCC version="1.0"> <qresource prefix="/"> <file>qtquickcontrols2.conf</file> </qresource> </RCC>
Hinweis: Qt Quick Controls verwendet einen Dateiselektor, um die Konfigurationsdatei zu laden. Es ist möglich, eine andere Konfigurationsdatei für verschiedene Plattformen und Sprachumgebungen bereitzustellen. Weitere Einzelheiten finden Sie in der Dokumentation QFileSelector.
Schließlich muss die Datei .qrc in der Build-Datei der Anwendung aufgeführt sein. Zum Beispiel:
set(CMAKE_AUTORCC ON)
qt_add_executable(my_app
application.qrc
main.cpp
...
)RESOURCES = application.qrc ...
Siehe auch: Build-System-Integration
Verwandte Informationen
© 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.
