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 von Qt Graphs QML Common Types.

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

Detaillierte Beschreibung

Dieser Typ wird verwendet, um visuelle Eigenschaften festzulegen, die das gesamte Diagramm betreffen. Es gibt mehrere integrierte Themen, die unverändert verwendet oder frei verändert werden können.

Themen können von Grund auf neu erstellt werden, indem man den GraphsTheme.Theme.UserDefined enum-Wert verwendet.

Theme anpassen

Das Standardthema ist QtGreen, aber es ist möglich, jede Eigenschaft anzupassen.

In der folgenden Tabelle sind die von einem Theme kontrollierten Eigenschaften und die Standardwerte für QGraphsTheme.Theme.UserDefined aufgeführt.

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`

Beispiele für die Verwendung

Verwendung eines eingebauten Designs ohne jegliche Änderungen:

Scatter3D {
    theme: GraphsTheme { theme: GraphsTheme.Theme.YellowSeries }
    ...

Verwendung eines eingebauten Themas und Änderung einiger Eigenschaften:

Bars3D {
    theme: GraphsTheme {
        theme: GraphsTheme.Theme.QtGreenNeon
        labelBorderVisible: true
        labelFont.pointSize: 35
        labelBackgroundVisible: false
    }
    ...

Verwendung eines benutzerdefinierten Themas:

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"
    }
    ...

Für GraphsTheme enums, siehe GraphsTheme::colorStyle und GraphsTheme::theme.

Eigenschaft Dokumentation

GraphsLine.labelTextColor : color

Die Farbe des für Beschriftungen verwendeten Textes. 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 er für Gitternetzlinien eingestellt ist, hat er nur Wirkung, wenn GraphsItem3D::gridLineType ist. Graphs3D.GridLineType.Shader

Siehe auch Graphs3D.GridLineType.

GraphsLine.subColor : color

Die Farbe der Unterlinien. Der Standardwert hängt von colorScheme ab.

GraphsLine.subWidth : real

Die Breite der Unterlinien. Der Standardwert ist 1.0.

Wenn er für Gitterlinien eingestellt ist, hat er nur Wirkung, wenn GraphsItem3D::gridLineType ist. Graphs3D.GridLineType.Shader

Siehe auch Graphs3D.GridLineType.

axisX : GraphsLine

Enthält die 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 die Beschriftungen auf axisX verwendet wird.

axisY : GraphsLine

Enthält die GraphsLine für die Y-Achse.

Siehe auch GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth, und GraphsLine.labelTextColor.

axisYLabelFont : font

Legt die Schriftart fest, die für die Beschriftungen auf axisY verwendet werden soll.

axisZ : GraphsLine

Enthält die GraphsLine für die Z-Achse.

Siehe auch GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth, und GraphsLine.labelTextColor.

axisZLabelFont : font

Legt die Schriftart fest, die für die Beschriftungen auf 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 Wertes von backgroundColor gezeichnet wird. Der Standardwert ist true.

baseColors : list<Color> [read-only]

Die Liste der Grundfarben vom Typ Farbe, die für alle Objekte im Diagramm verwendet werden sollen, und zwar Serie für Serie. Wenn es mehr Serien als Farben gibt, wird die Farbliste umbrochen und beginnt wieder mit der ersten Farbe in der Liste. Hat keine unmittelbare Auswirkung, wenn colorStyle nicht GraphsTheme.ColorStyle.Uniform ist.

Beispiel für die Verwendung:

baseColors: [ Color { color: "red" } ]

Dies kann durch explizites Setzen von Abstract3DSeries.baseColor in der Serie außer Kraft gesetzt werden.

baseGradients : list<Gradient> [read-only]

Die Liste der Basisfarbverläufe, die für alle Objekte im Diagramm verwendet werden sollen, Serie für Serie. Wenn es mehr Serien als Farbverläufe gibt, wird die Liste der Farbverläufe umbrochen und beginnt wieder mit dem ersten Farbverlauf in der Liste.

Hat keine unmittelbare Auswirkung, wenn colorStyle GraphsTheme.ColorStyle.Uniform ist.

Beispiel für die Verwendung:

baseGradients: [ Gradient {
    GradientStop { position: 1.0; color: "#DBEB00" }
    GradientStop { position: 0.0; color: "#373F26" }
} ]

Dieser Wert kann durch die explizite Angabe von Abstract3DSeries.baseGradient in der Serie außer Kraft gesetzt werden.

borderColors : list<color>

Die Liste der Rahmenfarben, die für alle Objekte im Diagramm verwendet werden sollen, Serie für Serie.

Wenn es mehr Serien als Farben gibt, wird die Farbliste umbrochen und beginnt wieder mit der ersten Farbe in der Liste.

Hat keine unmittelbare Auswirkung, wenn colorStyle nicht Uniform ist.

colorScheme : QGraphsTheme::ColorScheme

Das Farbschema des verwendeten Diagramms.

Siehe auch QGraphsTheme::ColorScheme.

colorStyle : GraphsTheme.ColorStyle

Der Stil der Diagrammfarben. Einer der QGraphsTheme::ColorStyle enum-Werte.

Dieser Wert kann durch explizites Setzen von Abstract3DSeries.colorStyle in der Serie überschrieben werden.

Hinweis: Diese Eigenschaft hat keine Auswirkung in Qt Graphs für 2D.

Siehe auch QGraphsTheme::ColorStyle.

grid : GraphsLine

Enthält die GraphsLine des Themas.

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 Gitternetzlinien aus. Der Standardwert ist true.

labelBackgroundColor : color

Die Farbe der Etikettenhintergründe. Hat keine Auswirkung, wenn labelBackgroundVisible gleich false 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 einem Hintergrund werden auf der Grundlage der längsten Beschriftung in gleicher Größe pro Achse gezeichnet, 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 Beschriftungsränder für Beschriftungen mit einem Hintergrund gezeichnet werden. Hat keine Auswirkung, wenn labelBackgroundVisible gleich false ist. Der Standardwert ist true.

labelFont : font

Legt die für Beschriftungen zu verwendende Schriftart fest.

labelTextColor : color

Die Farbe der Schriftart, die für Labels verwendet wird.

Wenn eine Achse labelTextColor explizit angegeben hat, hat dies keine Auswirkung.

Der Standardwert hängt von colorScheme ab.

labelsVisible : bool

Legt fest, ob Beschriftungen überhaupt gezeichnet werden. Wenn dies false ist, haben alle anderen Label-Eigenschaften keine Auswirkung. Der Standardwert ist true.

multiHighlightColor : color

Die Markierungsfarbe für ausgewählte Objekte. Wird verwendet, wenn selectionMode das Flag Graphs3D.SelectionFlag.Row oder Graphs3D.SelectionFlag.Column gesetzt hat. Der Standardwert hängt von colorScheme ab.

Siehe auch Graphs3D.SelectionFlag.

multiHighlightGradient : Gradient

Der Helligkeitsgradient für ausgewählte Objekte. Wird verwendet, wenn auf 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 des Diagrammbereichs. Der Standardwert hängt von colorScheme ab.

plotAreaBackgroundVisible : bool

Legt fest, ob der Hintergrund des Diagrammbereichs unter Verwendung des Werts von plotAreaBackgroundColor gezeichnet wird. Der Standardwert ist true.

seriesColors : list<color>

Die Liste der Farben, die für alle Objekte im Diagramm verwendet werden sollen, Serie für Serie. Wenn es mehr Serien als Farben gibt, wird die Farbliste umbrochen und beginnt wieder mit der ersten Farbe in der Liste. Hat keine unmittelbare Auswirkung, wenn colorStyle nicht GraphsTheme.ColorStyle.Uniform ist.

Beispiel für die Verwendung:

seriesColors: [ "red" ]

Dies kann durch explizites Setzen von Abstract3DSeries.baseColor in der Serie außer Kraft gesetzt werden.

singleHighlightColor : color

Die Hervorhebungsfarbe für ein ausgewähltes Objekt. Wird verwendet, wenn selectionMode das Flag Graphs3D.SelectionFlag.Item gesetzt hat. Der Standardwert hängt von colorScheme ab.

Siehe auch Graphs3D.SelectionFlag.

singleHighlightGradient : Gradient

Der Helligkeitsgradient für ein ausgewähltes Objekt. Wird verwendet, wenn auf 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. Wenn Sie den Thementyp ändern, nachdem das Element erstellt wurde, werden alle anderen Eigenschaften des Themas auf das vordefinierte Thema geändert. Wenn Sie den Thementyp des aktiven Themas des Diagramms ändern, werden auch alle angehängten Serien auf das neue Thema zurückgesetzt.

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