Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

Upgrade von „ Qt Quick Controls “ 1 Unterstützte Umgebungsvariablen

Qt Quick Controls Konfigurationsdatei

Qt Quick Controls unterstützen eine spezielle Konfigurationsdatei, „ qtquickcontrols2.conf “, die in die Ressourcen einer Anwendung integriert ist.

In der Konfigurationsdatei können der bevorzugte Stil und bestimmte stilbezogene Attribute festgelegt werden. Das folgende Beispiel legt fest, dass der bevorzugte Stil der „Material“-Stil ist. Wird die Anwendung im „Material“-Stil ausgeführt, ist das Design hell, und die Akzent- bzw. Primärfarben sind „Teal“ und „Blaugrau“. Wird die Anwendung hingegen im „Universal“-Stil 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

Mit der Umgebungsvariablen ` QT_QUICK_CONTROLS_CONF ` lässt sich ein benutzerdefinierter Speicherort für die Konfigurationsdatei festlegen.

Abschnitt „Controls“

Die folgenden Werte können im Abschnitt „ Controls “ der Konfigurationsdatei angegeben werden:

VariableBeschreibung
StyleLegt den Stil fest, mit dem die Anwendung ausgeführt werden soll. Der Wert kann der Name eines der integrierten Stile oder ein benutzerdefinierter Stil sein.
FallbackStyleLegt den Stil fest, der für nicht implementierte Steuerelemente verwendet werden soll. Der Stil muss einer der integrierten Stile sein. Standardmäßig wird der Stil „Basic“ verwendet.

Abschnitt „Imagine“

Die folgende Tabelle listet Werte auf, die zur Konfiguration des „Imagine“-Stils im Abschnitt „ Imagine “ der Konfigurationsdatei verwendet werden können:

VariableBeschreibung
PathGibt den Pfad zu dem Verzeichnis an, das die „Imagine“-Stil-Assets enthält. Wenn nichts angegeben wird, werden die integrierten Assets verwendet.

Beispiel für die Angabe eines Pfads zu einem Verzeichnis, 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 „ qtquickcontrols2.conf “ ist.

Abschnitt „Material“

Die folgende Tabelle listet Werte auf, die zur Konfiguration des Material-Stils im Abschnitt „ Material “ der Konfigurationsdatei verwendet werden können:

VariableBeschreibung
ThemeLegt das Standard -Material-Design fest. Der Wert kann eines der verfügbaren Designs sein, zum Beispiel „ "Dark" “.
VariantLegt die Material-Variante fest. Das Material-Design verfügt über zwei Varianten: eine normale Variante, die für Touch-Geräte konzipiert ist, und eine „dense“-Variante für den Desktop. Die „dense“-Variante verwendet kleinere Größen für Steuerelemente und deren Schriftarten.

Der Wert kann „ "Normal" “ oder „ "Dense" “ lauten.

AccentLegt die Standard-Akzentfarbe für Material fest. Der Wert kann ein beliebiger Wert unter color sein, es wird jedoch empfohlen, eine der vordefinierten Material-Farben zu verwenden, zum Beispiel "Teal".
PrimaryLegt die Standard-Hauptfarbe für Material fest. Der Wert kann ein beliebiger „ color “-Wert sein, es wird jedoch empfohlen, eine der vordefinierten Material-Farben zu verwenden, zum Beispiel "BlueGrey".
ForegroundLegt die Standard-Vordergrundfarbe für das Material fest. Der Wert kann ein beliebiger color sein oder eine der vordefinierten Materialfarben, zum Beispiel "Brown".
BackgroundLegt die Standard-Hintergrundfarbe des Materials fest. Der Wert kann ein beliebiges „ color “ oder eine der vordefinierten Materialfarben sein, zum Beispiel "Grey".

Abschnitt „Universal“

Die folgende Tabelle listet Werte auf, die zur Konfiguration des „Universal“-Stils im Abschnitt „ Universal “ der Konfigurationsdatei verwendet werden können:

VariableBeschreibung
ThemeLegt das Standard -Universal-Design fest. Der Wert kann eines der verfügbaren Designs sein, zum Beispiel "Dark".
AccentLegt die Standard -Akzentfarbe für „Universal“ fest. Der Wert kann eine beliebige „ color “-Farbe sein, es wird jedoch empfohlen, eine der vordefinierten „Universal“-Farben zu verwenden, zum Beispiel „ "Violet" “.
ForegroundLegt die Standard-Vordergrundfarbe für „Universal“ fest. Der Wert kann ein beliebiger Wert aus color sein oder eine der vordefinierten „Universal“-Farben, zum Beispiel "Brown".
BackgroundLegt die Standard-Universal-Hintergrundfarbe fest. Der Wert kann ein beliebiges ` color` oder eine der vordefinierten Universal-Farben sein, zum Beispiel ` "Steel"`.

Schriftartkonfiguration

Die Standard- font -Einstellung kann in der Untergruppe „ Font “ im Abschnitt jedes Stils in der Konfigurationsdatei festgelegt werden:

[Basic]
Font\Family=Open Sans
Font\PixelSize=20

Unterstützte Schriftattribute:

VariableBeschreibung
FamilyDie Schriftart „ font family “.
PointSizeDie „ point size “.
PixelSizeDie „ pixel size “.
StyleHintDie Variable „ style hint “. Mögliche Werte: „ SansSerif “, „ Helvetica “, „ Serif “, „ Times “, „ TypeWriter “, „ Courier “, „ OldEnglish “, „ Decorative “, „ Monospace “, „ Fantasy “, „ Cursive “.
WeightDie Schriftart „ weight “. Qt verwendet eine Schriftstärken-Skala von 1 bis 1000, die mit OpenType kompatibel ist. Eine Schriftstärke von 1 ist dünn, während 1000 extrem schwarz ist. Verfügbare vordefinierte Schriftstärken: Thin (100), ExtraLight (200), Light (300), Normal (400), Medium (500), DemiBold (600), Bold (700), ExtraBold (800), Black (900).
StyleDie „ style “. Mögliche Werte: „ StyleNormal “, „ StyleItalic “, „ StyleOblique “.

Palettenkonfiguration

Die Standard- palette n können 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

Weitere Informationen finden Sie unter dem QML-Typ „ Palette “.

Verwendung der Konfigurationsdatei in einem Projekt

Damit „ Qt Quick Controls “ die Konfigurationsdatei finden kann, muss sie mithilfe des Qt-Ressourcensystems in die Ressourcen der Anwendung eingebunden 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 eine Dateiauswahl, um die Konfigurationsdatei zu laden. Es ist möglich, für verschiedene Plattformen und Sprachumgebungen unterschiedliche Konfigurationsdateien bereitzustellen. Weitere Details finden Sie in der Dokumentation zu „ QFileSelector “.

Schließlich muss die Datei „ .qrc “ in der Build-Datei der Anwendung aufgeführt werden. Zum Beispiel:

set(CMAKE_AUTORCC ON)
qt_add_executable(my_app
    application.qrc
    main.cpp
    ...
)
RESOURCES = application.qrc
...

Siehe auch: Integration in das Build-System

Upgrade von „ Qt Quick Controls “ 1 Unterstützte Umgebungsvariablen

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