GraphsTheme QML Type
Ein visueller Stil für Diagramme. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QGraphsTheme |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- „GraphsTheme“ ist Teil der „Qt Graphs “ QML-Standardtypen.
Eigenschaften
- GraphsLine.labelTextColor : color
- GraphsLine.mainColor : color
- GraphsLine.mainWidth : real
- GraphsLine.subColor : color
- GraphsLine.subWidth : real
- axisX : GraphsLine
- axisXLabelFont : font
- axisY : GraphsLine
- axisYLabelFont : font
- axisZ : GraphsLine
- axisZLabelFont : font
- backgroundColor : color
- backgroundVisible : bool
- baseColors : list<Color>
- baseGradients : list<Gradient>
- borderColors : list<color>
- colorScheme : QGraphsTheme::ColorScheme
- colorStyle : GraphsTheme.ColorStyle
- grid : GraphsLine
- gridVisible : bool
- labelBackgroundColor : color
- labelBackgroundVisible : bool
- labelBorderVisible : bool
- labelFont : font
- labelTextColor : color
- labelsVisible : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- plotAreaBackgroundColor : color
- plotAreaBackgroundVisible : bool
- seriesColors : list<color>
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- theme : GraphsTheme.Theme
Ausführliche Beschreibung
Dieser Typ dient zur Festlegung visueller Eigenschaften, die sich auf das gesamte Diagramm auswirken. Es stehen mehrere integrierte Designs zur Verfügung, die unverändert verwendet oder beliebig angepasst werden können.
Themen können mithilfe des Enum-Werts „ GraphsTheme.Theme.UserDefined “ von Grund auf neu erstellt werden.
Anpassen des Themas
Das Standarddesign ist „QtGreen“, aber es ist möglich, jede Eigenschaft anzupassen.
Die folgende Tabelle listet die von einem Design gesteuerten Eigenschaften sowie die Standardwerte für „ QGraphsTheme.Theme.UserDefined “ auf.
| Eigenschaft | Standardwert |
|---|---|
| backgroundVisible | true |
| seriesColors | Qt::black |
| baseGradients | QLinearGradient. Im Wesentlichen vollständig schwarz. |
| colorStyle | Einheitlich |
| labelFont | QFont |
| gridVisible | true |
| labelBackgroundVisible | true |
| labelBorderVisible | true |
| labelsVisible | true |
Anwendungsbeispiele
Verwendung eines integrierten Themes ohne Änderungen:
Scatter3D {
theme: GraphsTheme { theme: GraphsTheme.Theme.YellowSeries }
...Verwendung eines integrierten Themes mit einigen Anpassungen:
Bars3D {
theme: GraphsTheme {
theme: GraphsTheme.Theme.QtGreenNeon
labelBorderVisible: true
labelFont.pointSize: 35
labelBackgroundVisible: false
}
...Verwendung eines benutzerdefinierten Themes:
Surface3D {
theme: GraphsTheme {
theme: GraphsTheme.Theme.UserDefined
backgroundColor: "red"
backgroundVisible: true
seriesColors: ["blue"]
colorStyle: GraphsTheme.ColorStyle.Uniform
labelFont.family: "Lucida Handwriting"
labelFont.pointSize: 35
gridVisible: false
grid.mainColor: "red"
grid.subColor: "blue"
labelBackgroundColor: "black"
labelBackgroundVisible: true
labelBorderVisible: false
labelTextColor: "white"
multiHighlightColor: "green"
singleHighlightColor: "darkRed"
}
...Informationen zu den „GraphsTheme“-Enums finden Sie unter GraphsTheme::colorStyle und GraphsTheme::theme.
Dokumentation zu den Eigenschaften
GraphsLine.labelTextColor : color
Die Farbe des für Beschriftungen verwendeten Texts. Der Standardwert hängt von „ colorScheme “ ab.
GraphsLine.mainColor : color
Die Farbe der Hauptlinien. Der Standardwert hängt von „ colorScheme “ ab.
GraphsLine.mainWidth : real
Die Breite der Hauptlinien. Der Standardwert ist „ 2.0 “.
Wenn dieser Wert für Gitterlinien festgelegt wird, wirkt er sich nur aus, wenn „ GraphsItem3D::gridLineType “ auf Graphs3D.GridLineType.Shader
Siehe auch „ Graphs3D.GridLineType “.
GraphsLine.subColor : color
Die Farbe der Unterzeilen. Der Standardwert hängt von ` colorScheme` ab.
GraphsLine.subWidth : real
Die Breite der Unterzeilen. Der Standardwert lautet „ 1.0 “.
Wenn dieser Wert für Gitterlinien festgelegt wird, wirkt er sich nur aus, wenn „ GraphsItem3D::gridLineType “ Graphs3D.GridLineType.Shader
Siehe auch „ Graphs3D.GridLineType “.
axisX : GraphsLine
Enthält den Wert „ GraphsLine “ der X-Achse.
Siehe auch „ GraphsLine.mainColor“ , „ GraphsLine.subColor “, „ GraphsLine.mainWidth “, „ GraphsLine.subWidth “ und „ GraphsLine.labelTextColor “.
axisXLabelFont : font
Legt die Schriftart fest, die für Beschriftungen auf axisX verwendet werden soll.
axisY : GraphsLine
Enthält den Wert „ GraphsLine “ der Y-Achse.
Siehe auch „ GraphsLine.mainColor“ , „ GraphsLine.subColor “, „ GraphsLine.mainWidth “, „ GraphsLine.subWidth “ und „ GraphsLine.labelTextColor “.
axisYLabelFont : font
Legt die Schriftart fest, die für Beschriftungen auf axisY verwendet werden soll.
axisZ : GraphsLine
Enthält den GraphsLine der Z-Achse.
Siehe auch „ GraphsLine.mainColor“ , „ GraphsLine.subColor “, „ GraphsLine.mainWidth “, „ GraphsLine.subWidth “ und „ GraphsLine.labelTextColor “.
axisZLabelFont : font
Legt die Schriftart fest, die für Beschriftungen unter „ axisZ “ verwendet werden soll.
backgroundColor : color
Die Farbe der Ansicht, in die das Diagramm gezeichnet wird. Der Standardwert hängt von „ colorScheme “ ab.
backgroundVisible : bool
Legt fest, ob der Hintergrund der Ansicht unter Verwendung des Werts von „ backgroundColor “ gezeichnet wird. Der Standardwert ist „ true “.
baseColors : list<Color> [read-only]
Die Liste der Grundfarben vom Typ „Color“, die für alle Objekte im Diagramm verwendet werden sollen, Reihe für Reihe. Wenn es mehr Reihen als Farben gibt, wird die Farbliste umgebrochen und beginnt erneut mit der ersten Farbe in der Liste. Hat keine unmittelbare Wirkung, wenn „ colorStyle “ nicht auf „ GraphsTheme.ColorStyle.Uniform “ gesetzt ist.
Anwendungsbeispiel:
baseColors: [ Color { color: "red" } ]Dies kann überschrieben werden, indem ` Abstract3DSeries.baseColor ` explizit in der Reihe festgelegt wird.
baseGradients : list<Gradient> [read-only]
Die Liste der Basis-Farbverläufe, die für alle Objekte im Diagramm verwendet werden sollen, Reihe für Reihe. Wenn es mehr Reihen als Farbverläufe gibt, wird die Liste der Farbverläufe umgebrochen und beginnt erneut mit dem ersten Farbverlauf in der Liste.
Hat keine unmittelbare Auswirkung, wenn „ colorStyle “ auf „ GraphsTheme.ColorStyle.Uniform “ gesetzt ist.
Anwendungsbeispiel:
baseGradients: [ Gradient {
GradientStop { position: 1.0; color: "#DBEB00" }
GradientStop { position: 0.0; color: "#373F26" }
} ]Dieser Wert kann überschrieben werden, indem „ Abstract3DSeries.baseGradient “ in der jeweiligen Reihe explizit festgelegt wird.
borderColors : list<color>
Die Liste der Rahmenfarben, die für alle Objekte im Diagramm verwendet werden sollen, Reihe für Reihe.
Wenn es mehr Reihen als Farben gibt, wird die Farbliste umgebrochen und beginnt erneut mit der ersten Farbe in der Liste.
Hat keine unmittelbare Auswirkung, wenn „ colorStyle “ nicht auf „Uniform“ gesetzt ist.
colorScheme : QGraphsTheme::ColorScheme
Das Farbschema der verwendeten Grafik.
Siehe auch QGraphsTheme::ColorScheme.
colorStyle : GraphsTheme.ColorStyle
Der Stil der Diagrammfarben. Einer der Werte der Aufzählung „ QGraphsTheme::ColorStyle “.
Dieser Wert kann überschrieben werden, indem „ Abstract3DSeries.colorStyle “ in der Reihe explizit festgelegt wird.
Hinweis: Diese Eigenschaft hat bei Qt Graphs für 2D keine Auswirkung.
Siehe auch „ QGraphsTheme::ColorStyle “.
grid : GraphsLine
Enthält die „ GraphsLine “ des Themes.
Siehe auch „ GraphsLine.mainColor“ , „ GraphsLine.subColor “, „ GraphsLine.mainWidth “, „ GraphsLine.subWidth “ und „ GraphsLine.labelTextColor “.
gridVisible : bool
Legt fest, ob die Gitterlinien gezeichnet werden. Dieser Wert wirkt sich auf alle Gitterlinien aus. Der Standardwert lautet „ true “.
labelBackgroundColor : color
Die Farbe des Etikettenhintergrunds. Hat keine Auswirkung, wenn „ labelBackgroundVisible “ auf „ false “ gesetzt ist. Der Standardwert hängt von „ colorScheme “ ab.
labelBackgroundVisible : bool
Legt fest, ob die Beschriftung mit einem Hintergrund gezeichnet wird, der „ labelBackgroundColor “ (einschließlich Alpha) verwendet, oder mit einem vollständig transparenten Hintergrund. Beschriftungen mit Hintergrund werden je nach Achse in gleicher Größe gezeichnet, basierend auf der längsten Beschriftung, und der Text wird darin zentriert. Beschriftungen ohne Hintergrund werden unverändert gezeichnet und je nach ihrer Position im Diagramm links- oder rechtsbündig ausgerichtet. Der Standardwert ist „ true “.
labelBorderVisible : bool
Legt fest, ob für Beschriftungen mit Hintergrund Rahmen gezeichnet werden. Hat keine Auswirkung, wenn „ labelBackgroundVisible “ auf „ false “ gesetzt ist. Der Standardwert ist „ true “.
labelFont : font
Legt die Schriftart fest, die für Beschriftungen verwendet werden soll.
labelTextColor : color
Die Farbe der für Beschriftungen verwendeten Schriftart.
Wenn für eine Achse explizit „ labelTextColor “ angegeben wurde, hat dies keine Auswirkung.
Der Standardwert hängt von „ colorScheme “ ab.
labelsVisible : bool
Legt fest, ob Beschriftungen überhaupt gezeichnet werden. Wenn hier „ false “ angegeben ist, haben alle anderen Beschriftungseigenschaften keine Auswirkung. Der Standardwert ist „ true “.
multiHighlightColor : color
Die Hervorhebungsfarbe für ausgewählte Objekte. Wird verwendet, wenn für „ selectionMode “ das Flag „ Graphs3D.SelectionFlag.Row “ oder „ Graphs3D.SelectionFlag.Column “ gesetzt ist. Der Standardwert hängt von „ colorScheme “ ab.
Siehe auch Graphs3D.SelectionFlag.
multiHighlightGradient : Gradient
Der Hervorhebungsgradient für ausgewählte Objekte. Wird verwendet, wenn für „ selectionMode “ das Flag „ Graphs3D.SelectionFlag.Row “ oder „ Graphs3D.SelectionFlag.Column “ gesetzt ist. Der Standardwert hängt von „ colorScheme “ ab.
Siehe auch Graphs3D.SelectionFlag.
plotAreaBackgroundColor : color
Die Farbe des Hintergrunds im Diagrammbereich. Der Standardwert hängt von der Einstellung „ colorScheme “ ab.
plotAreaBackgroundVisible : bool
Legt fest, ob der Hintergrund des Darstellungsbereichs unter Verwendung des Werts „ plotAreaBackgroundColor “ gezeichnet wird. Der Standardwert ist „ true “.
seriesColors : list<color>
Die Liste der Farben, die für alle Objekte im Diagramm verwendet werden sollen, Reihe für Reihe. Wenn es mehr Reihen als Farben gibt, wird die Farbliste umgebrochen und beginnt erneut mit der ersten Farbe in der Liste. Hat keine unmittelbare Wirkung, wenn „ colorStyle “ nicht auf „ GraphsTheme.ColorStyle.Uniform “ gesetzt ist.
Anwendungsbeispiel:
seriesColors: [ "red" ]Dies kann überschrieben werden, indem ` Abstract3DSeries.baseColor ` explizit in der Reihe festgelegt wird.
singleHighlightColor : color
Die Hervorhebungsfarbe für ein ausgewähltes Objekt. Wird verwendet, wenn für „ selectionMode “ das Flag „ Graphs3D.SelectionFlag.Item “ gesetzt ist. Der Standardwert hängt von „ colorScheme “ ab.
Siehe auch Graphs3D.SelectionFlag.
singleHighlightGradient : Gradient
Der Hervorhebungsgradient für ein ausgewähltes Objekt. Wird verwendet, wenn für „ selectionMode “ das Flag „ Graphs3D.SelectionFlag.Item “ gesetzt ist. Der Standardwert hängt von „ colorScheme “ ab.
Siehe auch Graphs3D.SelectionFlag.
theme : GraphsTheme.Theme
Der Typ des Themas. Wenn kein Typ festgelegt ist, lautet der Typ „ GraphsTheme.Theme.QtGreen “. Wird der Thematyp nach der Erstellung des Elements geändert, werden alle anderen Eigenschaften des Themas auf die Werte angepasst, die das vordefinierte Thema vorgibt. Durch Ändern des Thematyps des aktiven Themas des Diagramms werden außerdem alle zugehörigen Reihen zurückgesetzt, sodass sie das neue Thema verwenden.
© 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.