ColorGroup QML Type
Die Farbpalette nach Rollen. Mehr...
Eigenschaften
- accent : color
(since 6.6) - alternateBase : color
- base : color
- brightText : color
- button : color
- buttonText : color
- dark : color
- highlight : color
- highlightedText : color
- light : color
- link : color
- linkVisited : color
- mid : color
- midlight : color
- placeholderText : color
(since 6.2) - shadow : color
- text : color
- toolTipBase : color
- toolTipText : color
- window : color
- windowText : color
Signale
- changed()
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 “.
link : color
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.