Auf dieser Seite

ColorGroup QML Type

Die Menge der Farben nach Rollen. Mehr...

Import Statement: import QtQuick
Inherits:

QtObject

Inherited By:

Palette

Eigenschaften

Signale

Detaillierte Beschreibung

Der Typ ColorGroup wird verwendet, um eine Reihe von Farben mit bestimmten Rollen zu definieren. Obwohl eine ColorGroup kein visuelles Erscheinungsbild hat, definiert sie Farben, die zur Anpassung von gerenderten Elementen verwendet werden.

Die Standardwerte der Farben sind gleich den aktiven Gruppenfarben der standardmäßig erstellten QPalette.

Der folgende Code kann verwendet werden, um eine Farbgruppe mit einigen angegebenen Farben zu erstellen:

ColorGroup {
    alternateBase: "red"
    base: "green"
}

Der Typ Palette stellt Farbgruppen für jeden QML-Elementstatus zur Verfügung.

Dokumentation der Eigenschaft

accent : color [since 6.6]

Eine Farbe, die typischerweise einen Kontrast zu den Farben base, window und button bildet oder diese ergänzt. Sie steht in der Regel für die von den Benutzern gewählte Desktop-Personalisierung. Die Gestaltung interaktiver Komponenten ist ein typischer Anwendungsfall. Wenn sie nicht explizit gesetzt wird, ist sie standardmäßig auf highlight eingestellt.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

alternateBase : color

Wird als alternative Hintergrundfarbe in Artikelansichten mit alternierenden Zeilenfarben verwendet.

base : color

Wird meist als Hintergrundfarbe für Texteditor-Steuerelemente und Elementansichten verwendet. Normalerweise ist sie weiß oder eine andere helle Farbe.

brightText : color

Eine Textfarbe, die sich stark von windowText unterscheidet und einen guten Kontrast zu z. B. dark bildet. Normalerweise wird sie für Text verwendet, der dort gezeichnet werden muss, wo text, windowText oder buttonText einen schlechten Kontrast ergeben würden, z. B. auf hervorgehobenen Schaltflächen.

button : color

Die allgemeine Hintergrundfarbe der Schaltfläche. Dieser Hintergrund kann sich von window unterscheiden, da einige Stile eine andere Hintergrundfarbe für Schaltflächen erfordern.

buttonText : color

Eine Vordergrundfarbe, die zusammen mit der Farbe palette verwendet wird.

dark : color

Eine Vordergrundfarbe, die zusammen mit der Farbe palette verwendet wird.

highlight : color

Eine Farbe zur Kennzeichnung eines ausgewählten Elements oder des aktuellen Elements.

highlightedText : color

Eine Textfarbe, die im Kontrast zu highlight steht.

light : color

Leichter als button.

Eine Textfarbe, die für Hyperlinks verwendet wird.

linkVisited : color

Eine Textfarbe, die für bereits besuchte Hyperlinks verwendet wird.

mid : color

Zwischen palette.button und dark.

midlight : color

Zwischen button und light.

placeholderText : color [since 6.2]

Wird als Platzhalterfarbe für editierbare einzeilige Felder verwendet.

Diese Eigenschaft wurde in Qt 6.2 eingeführt.

shadow : color

Eine sehr dunkle Farbe.

text : color

Die bei base verwendete Vordergrundfarbe. Diese ist in der Regel dieselbe wie die windowText, wobei sie einen guten Kontrast zu window und base bieten muss.

toolTipBase : color

Wird als Hintergrundfarbe für Tooltips verwendet.

toolTipText : color

Wird als Vordergrundfarbe für Tooltips verwendet.

window : color

Eine allgemeine Hintergrundfarbe.

windowText : color

Eine allgemeine Farbe für den Vordergrund.

Signal Dokumentation

changed()

Zusätzliches Signal zeigt an, dass der aktuelle Zustand dieser Farbgruppe geändert wurde. Normalerweise bedeutet es, dass eine der Farben geändert wurde.

Hinweis: Der entsprechende Handler ist onChanged.

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