ColorGroup QML Type
Die Menge der Farben 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()
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.
link : color
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.