Auf dieser Seite

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

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.

Galerie der Steuerelemente im „Universal“-Stil mit hellem Design

Das helle Design des „Universal“-Stils.

Galerie der Steuerelemente im „Universal“-Stil mit dunklem Design

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.

Knöpfe im universellen Stil, die Themen- und Akzentattribute anzeigen

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:

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Universal

ApplicationWindow {
    visible: true

    Universal.theme: Universal.Dark
    Universal.accent: Universal.Violet

    Column {
        anchors.centerIn: parent

        RadioButton { text: qsTr("Small") }
        RadioButton { text: qsTr("Medium");  checked: true }
        RadioButton { text: qsTr("Large") }
    }
}

Steuerelemente im Universal-Design mit individuellen violetten Akzenten

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

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 ein beliebiges „ color “ 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 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

VariableBeschreibung
QT_QUICK_CONTROLS_UNIVERSAL_THEMELegt das Standard -Universal-Design fest. Der Wert kann eines der verfügbaren Designs sein, zum Beispiel "Dark".
QT_QUICK_CONTROLS_UNIVERSAL_ACCENTLegt 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_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".
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUNDLegt 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:

KonstantBeschreibung
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:

Button {
    text: qsTr("Button")
    highlighted: true
    Universal.accent: Universal.Orange
}

Universelle Steuerelemente, die die Akzentfarbe anzeigen

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:

Pane {
    Universal.background: Universal.Steel

    Button {
        text: qsTr("Button")
    }
}

Universelle Steuerelemente, die die Hintergrundfarbe anzeigen


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:

Button {
    text: qsTr("Button")
    Universal.foreground: Universal.Pink
}

Universelle Steuerelemente, die die Vordergrundfarbe anzeigen


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:

KonstanteBeschreibung
Universal.LightHelles Design (Standard)
Universal.DarkDunkles Design
Universal.SystemSystem-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:

Pane {
    Universal.theme: Universal.Dark

    Button {
        text: qsTr("Button")
    }
}

Universelle Steuerelemente für helle und dunkle Designs


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)
}

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