Auf dieser Seite

ColorGroup QML Type

Die Farbpalette nach Rollen. Mehr...

Import Statement: import QtQuick
Inherits:

QtObject

Inherited By:

Palette

Eigenschaften

Signale

Ausführliche Beschreibung

Der Typ „ColorGroup“ wird verwendet, um eine Reihe von Farben mit bestimmten Funktionen zu definieren. Obwohl eine „ColorGroup“ selbst keine visuelle Darstellung hat, definiert sie Farben, die zur Anpassung gerenderter Elemente verwendet werden.

Die Standardwerte der Farben entsprechen den aktiven Gruppenfarben eines standardmäßig erstellten ` QPalette`.

Mit dem folgenden Code lässt sich eine Farbgruppe mit einigen festgelegten Farben erstellen:

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

Der Typ „ Palette “ stellt Farbgruppen für jeden Zustand eines QML-Elements bereit.

Dokumentation zu den Eigenschaften

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 vom Benutzer gewählte Desktop-Anpassung. Ein typischer Anwendungsfall ist die Gestaltung interaktiver Komponenten. Sofern nicht ausdrücklich festgelegt, lautet der Standardwert „ highlight “.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

alternateBase : color

Wird als alternative Hintergrundfarbe in Elementansichten mit abwechselnden Zeilenfarben verwendet.

base : color

Wird hauptsächlich als Hintergrundfarbe für Steuerelemente in Texteditoren und in Elementansichten verwendet. Meistens ist sie weiß oder eine andere helle Farbe.

brightText : color

Eine Textfarbe, die sich deutlich von windowText unterscheidet und einen guten Kontrast zu beispielsweise dark bildet. Wird in der Regel für Text verwendet, der an Stellen dargestellt werden soll, an denen text, windowText oder buttonText einen schlechten Kontrast ergeben würden, wie beispielsweise auf hervorgehobenen Schaltflächen.

button : color

Die allgemeine Hintergrundfarbe der Schaltflächen. Dieser Hintergrund kann von window abweichen, da manche 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, die ein ausgewähltes Element oder das aktuelle Element kennzeichnet.

highlightedText : color

Eine Textfarbe, die sich von „ highlight “ abhebt.

light : color

Leichter als „ button “.

Eine Textfarbe, die für Hyperlinks verwendet wird.

linkVisited : color

Eine Textfarbe für bereits besuchte Hyperlinks.

mid : color

Zwischen palette.button und dark.

midlight : color

Zwischen button und light.

placeholderText : color [since 6.2]

Wird als Platzhalterfarbe für bearbeitbare einzeilige Felder verwendet.

Diese Eigenschaft wurde in Qt 6.2 eingeführt.

shadow : color

Eine sehr dunkle Farbe.

text : color

Die mit „ base “ verwendete Vordergrundfarbe. Diese entspricht in der Regel der „ windowText “; in diesem Fall muss sie einen guten Kontrast zu „ window “ und „ base “ bilden.

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

Signal-Dokumentation

changed()

Ein zusätzliches Signal zeigt an, dass sich der aktuelle Status dieser Farbgruppe geändert hat. In der Regel bedeutet dies, dass eine der Farben geändert wurde.

Hinweis: Der entsprechende Handler lautet 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.