Auf dieser Seite

GraphsTheme QML Type

Ein visueller Stil für Diagramme. Mehr...

Import Statement: import QtGraphs
In C++: QGraphsTheme

Eigenschaften

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.

EigenschaftStandardwert
backgroundVisibletrue
seriesColorsQt::black
baseGradientsQLinearGradient. Im Wesentlichen vollständig schwarz.
colorStyleEinheitlich
labelFontQFont
gridVisibletrue
labelBackgroundVisibletrue
labelBorderVisibletrue
labelsVisibletrue

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.