Universeller Stil
Der universelle Stil basiert auf den Microsoft-Richtlinien für universelles Design. Mehr...
| Import-Anweisung: | import QtQuick.Controls.Universal |
| Seit: | Qt 5.7 |
Angeschlossene Eigenschaften
- accent: Farbe
- Hintergrund: Farbe
- Vordergrund: Farbe
- Thema: Aufzählung
Zugehörige Methoden
- Farbe Farbe(vordefinierte Aufzählung)
Ausführliche Beschreibung
Der „Universal“-Stil ist ein geräteunabhängiger Stil, der auf den Microsoft-Richtlinien für universelles Design basiert. Der „Universal“-Stil wurde so konzipiert, dass er auf allen Geräten gut aussieht, von Smartphones und Tablets bis hin zu PCs.
Das helle Design des „Universal“-Stils. |
Das dunkle Design des „Universal“-Stils. |
Informationen zum Ausführen einer Anwendung mit dem Universal-Stil finden Sie unter „Verwenden von Stilen“ unter Qt Quick Controls.
Hinweis: Der „Universal“-Stil ist kein nativer Windows 10-Stil. Der „Universal“-Stil ist eine zu 100 % plattformübergreifende Implementierung des „ Qt Quick Controls “-Stils, die den Microsoft Universal Design Guidelines entspricht. Der Stil läuft auf jeder Plattform und sieht überall mehr oder weniger identisch aus. Geringfügige Abweichungen können aufgrund von Unterschieden bei den verfügbaren Systemschriftarten und Schriftart-Rendering-Engines auftreten.
Anpassung
Der „Universal“-Stil ermöglicht die Anpassung von vier Attributen: Design, Akzentfarbe, Vordergrundfarbe und Hintergrundfarbe.

Beide Attribute können für jedes Fenster oder Element festgelegt werden und werden automatisch an untergeordnete Elemente weitergegeben, genau wie bei „ fonts “. Im folgenden Beispiel werden das Fenster und alle drei Optionsfelder im dunklen Design mit einer violetten Akzentfarbe angezeigt:
|
|
Neben der Festlegung der Attribute in QML ist es auch möglich, diese über Umgebungsvariablen oder in einer Konfigurationsdatei festzulegen. In QML festgelegte Attribute haben Vorrang vor allen anderen Methoden.
Konfigurationsdatei
| Variable | Beschreibung |
|---|---|
Theme | Legt das Standard -Universal-Design fest. Der Wert kann eines der verfügbaren Designs sein, zum Beispiel "Dark". |
Accent | Legt die Standard -Akzentfarbe für „Universal“ fest. Der Wert kann ein beliebiges „ color “ sein, es wird jedoch empfohlen, eine der vordefinierten „Universal“-Farben zu verwenden, zum Beispiel „ "Violet" “. |
Foreground | Legt 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". |
Background | Legt die Standard-Universal-Hintergrundfarbe fest. Der Wert kann ein beliebiger Wert aus dem Bereich color sein oder eine der vordefinierten Universal-Farben, zum Beispiel "Steel". |
Weitere Informationen zur Konfigurationsdatei finden Sie unter „Qt Quick Controls -Konfigurationsdatei “.
Umgebungsvariablen
| Variable | Beschreibung |
|---|---|
QT_QUICK_CONTROLS_UNIVERSAL_THEME | Legt das Standard -Universal-Design fest. Der Wert kann eines der verfügbaren Designs sein, zum Beispiel "Dark". |
QT_QUICK_CONTROLS_UNIVERSAL_ACCENT | Legt die Standard-Akzentfarbe für „Universal“ fest. Der Wert kann ein beliebiges „ color “ sein, es wird jedoch empfohlen, eine der vordefinierten „Universal“-Farben zu verwenden, zum Beispiel "Violet". |
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND | Legt 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". |
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND | Legt die Standard-Universal-Hintergrundfarbe fest. Der Wert kann ein beliebiger Wert aus dem Bereich color sein oder eine der vordefinierten Universal-Farben, zum Beispiel "Steel". |
Eine vollständige Liste der unterstützten Umgebungsvariablen finden Sie unter „Unterstützte Umgebungsvariablen“ in Qt Quick Controls.
Abhängigkeit
Der „Universal“-Stil muss separat importiert werden, um Zugriff auf die für den „Universal“-Stil spezifischen Attribute zu erhalten. Es ist zu beachten, dass unabhängig von den Verweisen auf den „Universal“-Stil derselbe Anwendungscode auch mit jedem anderen Stil ausgeführt wird. „Universal“-spezifische Attribute wirken sich nur aus, wenn die Anwendung mit dem „Universal“-Stil ausgeführt wird.
Wird der „Universal“-Stil in eine QML-Datei importiert, die stets geladen wird, muss der „Universal“-Stil zusammen mit der Anwendung bereitgestellt werden, damit die Anwendung unabhängig vom verwendeten Stil ausgeführt werden kann. Durch die Verwendung von Dateiselektoren lassen sich stilbezogene Anpassungen vornehmen, ohne eine feste Abhängigkeit von einem Stil zu schaffen.
Vordefinierte Universal-Farben
Verfügbare vordefinierte Farben:
| Konstant | Beschreibung |
|---|---|
Universal.Lime | #A4C400 |
Universal.Green | #60A917 |
Universal.Emerald | #008A00 |
Universal.Teal | #00ABA9 |
Universal.Cyan | #1BA1E2 |
Universal.Cobalt | #3E65FF (Standard-Akzent) |
Universal.Indigo | #6A00FF |
Universal.Violet | #AA00FF |
Universal.Pink | #F472D0 |
Universal.Magenta | #D80073 |
Universal.Crimson | #A20025 |
Universal.Red | #E51400 |
Universal.Orange | #FA6800 |
Universal.Amber | #F0A30A |
Universal.Yellow | #E3C800 |
Universal.Brown | #825A2C |
Universal.Olive | #6D8764 |
Universal.Steel | #647687 |
Universal.Mauve | #76608A |
Universal.Taupe | #87794E |
Siehe auch „Grundlegender Stil“, „Materialstil“
Dokumentation zu angehängten Eigenschaften
Universal.accent: Farbe |
Diese angehängte Eigenschaft enthält die Akzentfarbe des Themes. Die Eigenschaft kann an jedes Fenster oder Element angehängt werden. Der Wert wird an untergeordnete Elemente weitergegeben.
Der Standardwert lautet „ Universal.Cobalt “.
Im folgenden Beispiel wird die Akzentfarbe der hervorgehobenen Schaltfläche auf „ Universal.Orange “ geändert:
|
|
Hinweis: Auch wenn die Akzentfarbe beliebig unter color gewählt werden kann, wird empfohlen, eine der vordefinierten Universal-Farben zu verwenden, die so gestaltet wurden, dass sie gut mit dem Rest der Universal-Stilpalette harmonieren.
Universal.background: color |
Diese angehängte Eigenschaft enthält die Hintergrundfarbe des Themes. Die Eigenschaft kann an jedes Fenster oder Element angehängt werden. Der Wert wird an untergeordnete Elemente weitergegeben.
Der Standardwert ist themenspezifisch (hell oder dunkel).
Im folgenden Beispiel wird die Hintergrundfarbe des Fensters auf „ Universal.Steel “ geändert:
Universal.foreground: color |
Diese angehängte Eigenschaft enthält die Vordergrundfarbe des Themes. Die Eigenschaft kann an jedes Fenster oder Element angehängt werden. Der Wert wird an untergeordnete Elemente weitergegeben.
Der Standardwert ist themenspezifisch (hell oder dunkel).
Im folgenden Beispiel wird die Vordergrundfarbe der Schaltfläche auf „ Universal.Pink “ gesetzt:
|
|
Universal.theme: Aufzählung |
Diese angehängte Eigenschaft gibt an, ob das Design hell oder dunkel ist. Die Eigenschaft kann an jedes Fenster oder Element angehängt werden. Der Wert wird an untergeordnete Elemente weitergegeben.
Verfügbare Designs:
| Konstante | Beschreibung |
|---|---|
Universal.Light | Helles Design (Standard) |
Universal.Dark | Dunkles Design |
Universal.System | System-Design |
Wenn das Design auf „ System “ gesetzt wird, wird je nach den Farben des Systemdesigns entweder das helle oder das dunkle Design ausgewählt. Beim Auslesen des Werts der Eigenschaft „theme“ ist der Wert jedoch niemals „ System “, sondern das tatsächlich verwendete Design.
Im folgenden Beispiel ist das Design sowohl für den Bereich als auch für die Schaltfläche auf „ Universal.Dark “ gesetzt:
Beigefügte Methodendokumentation
color color( vordefinierteAufzählung ) |
Diese angehängte Methode gibt den effektiven Farbwert der angegebenen vordefinierten Universal-Farbe zurück.
Rectangle {
color: Universal.color(Universal.Red)
}Weiterführende Informationen
© 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.






