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.
Eigenschaft Dokumentation
accent : color |
Eine Farbe, die typischerweise einen Kontrast zu den Farben base, window und button bildet oder diese ergänzt. Sie stellt in der Regel die vom Benutzer gewählte Desktop-Personalisierung dar. 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 Elementansichten mit alternierenden Zeilenfarben verwendet.
base : color |
Wird meist als Hintergrundfarbe für Texteditor-Steuerelemente und Elementansichten verwendet. Sie ist normalerweise 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. Sie wird in der Regel für Text verwendet, der dort gezeichnet werden muss, wo text
, windowText
oder buttonText
einen schlechten Kontrast ergeben würden, z. B. bei 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 mit der Farbe palette
verwendet wird.
dark : color |
Eine Vordergrundfarbe, die mit der Farbe von palette
verwendet wird.
highlight : color |
Eine Farbe, die ein ausgewähltes Element oder das aktuelle Element anzeigt.
highlightedText : color |
Eine Textfarbe, die einen Kontrast zu highlight
bildet.
light : color |
Heller 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 |
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 Vordergrundfarbe, die mit base
verwendet wird. Normalerweise ist dies die gleiche Farbe wie windowText
, in diesem Fall muss sie einen guten Kontrast zu window
und base
bieten.
toolTipBase : color |
Wird als Hintergrundfarbe für Tooltips verwendet.
toolTipText : color |
Wird als Vordergrundfarbe für QuickInfos 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
.
© 2025 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.