Back to Qt.io
Contact Us Blog Download Qt

Theme3D QML Type

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

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
In C++: Q3DTheme

Eigenschaften

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.

Die folgenden Eigenschaften können durch die Verwendung von Abstract3DSeries überschrieben werden, um sie explizit in der Serie festzulegen: baseColors, baseGradients, und colorStyle.

Themen können von Grund auf neu erstellt werden, indem der Wert Theme3D.ThemeUserDefined enum verwendet wird.

Standardthema

In der folgenden Tabelle sind die von Themen kontrollierten Eigenschaften und die Standardwerte für Theme3D.ThemeUserDefined aufgeführt.

EigenschaftStandardwert
ambientLightStrength0.25
backgroundColor"schwarz". Für weitere Informationen siehe color.
backgroundEnabledtrue
baseColors"schwarz"
baseGradientsQLinearGradient. Im Wesentlichen vollständig schwarz.
colorStyleColorStyleUniform
fontfont
gridEnabledtrue
gridLineColor"weiß"
highlightLightStrength7.5
labelBackgroundColor"grau"
labelBackgroundEnabledtrue
labelBorderEnabledtrue
labelTextColor"weiß"
lightColor"weiß"
lightStrength5.0
multiHighlightColor"blau"
multiHighlightGradientQLinearGradient. Im Wesentlichen vollständig schwarz.
singleHighlightColor"rot"
singleHighlightGradientQLinearGradient. Im Wesentlichen vollständig schwarz.
windowColor"schwarz" .

Beispiele für die Verwendung

Verwendung eines eingebauten Themas ohne jegliche Änderungen:

Scatter3D {
    ...
    theme: Theme3D { type: Theme3D.ThemeRetro }
    ...
}

Verwendung eines eingebauten Themas und Änderung einiger Eigenschaften:

Bars3D {
    ...
    theme: Theme3D {
        type: Theme3D.ThemeRetro
        labelBorderEnabled: true
        font.pointSize: 35
        labelBackgroundEnabled: false
    }
    ...
}

Verwendung eines benutzerdefinierten Themas:

Surface3D {
    ...
    theme: Theme3D {
        ambientLightStrength: 0.5
        backgroundColor: "red"
        backgroundEnabled: true
        baseColor: "blue"
        colorStyle: Theme3D.ColorStyleUniform
        font.family: "Lucida Handwriting"
        font.pointSize: 35
        gridEnabled: false
        gridLineColor: "black"
        highlightLightStrength: 0.5
        labelBackgroundColor: "black"
        labelBackgroundEnabled: true
        labelBorderEnabled: false
        labelTextColor: "white"
        lightColor: "yellow"
        lightStrength: 0.4
        multiHighlightColor: "green"
        singleHighlightColor: "darkRed"
        windowColor: "white"
    }
    ...
}

Für Theme3D-Enums, siehe Q3DTheme::ColorStyle und Q3DTheme::Theme.

Eigenschaft Dokumentation

ambientLightStrength : real

Die Stärke des Umgebungslichts für die gesamte Grafik. Dieser Wert bestimmt, wie gleichmäßig und hell die Farben im gesamten Diagramm unabhängig von der Lichtposition dargestellt werden. Der Wert muss zwischen 0.0 und 1.0 liegen.


backgroundColor : color

Die Farbe des Diagrammhintergrunds.


backgroundEnabled : bool

Legt fest, ob der Hintergrund unter Verwendung des Wertes von backgroundColor gezeichnet wird.


baseColors : list<ThemeColor>

Die Liste der Grundfarben, die für alle Objekte im Diagramm verwendet werden sollen, und zwar für jede einzelne 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 Theme3D.ColorStyleUniform ist.

Dies kann durch die explizite Angabe von Abstract3DSeries.baseColor in der Serie außer Kraft gesetzt werden.


baseGradients : list<ColorGradient>

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 Theme3D.ColorStyleUniform ist.

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


colorStyle : Theme3D.ColorStyle

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

Dieser Wert kann durch eine explizite Einstellung von Abstract3DSeries.colorStyle in der Serie überschrieben werden.

Siehe auch Q3DTheme::ColorStyle.


font : font

Legt die für Beschriftungen zu verwendende Schriftart fest.


gridEnabled : bool

Legt fest, ob die Gitterlinien gezeichnet werden. Dieser Wert wirkt sich auf alle Gitternetzlinien aus.


gridLineColor : color

Die Farbe der Gitternetzlinien.

Hinweis: Transparenz wird nicht unterstützt und führt zu einem undefinierten Verhalten.


highlightLightStrength : real

Die Stärke des Glanzlichts für ausgewählte Objekte. Der Wert muss zwischen 0.0 und 10.0 liegen.


labelBackgroundColor : color

Die Farbe der Beschriftungshintergründe. Hat keine Auswirkung, wenn labelBackgroundEnabled gleich false ist.


labelBackgroundEnabled : 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.


labelBorderEnabled : bool

Legt fest, ob Etikettenränder für Etiketten mit einem Hintergrund gezeichnet werden. Hat keine Auswirkung, wenn labelBackgroundEnabled false ist.


labelTextColor : color

Die Farbe der für die Beschriftungen verwendeten Schriftart.


lightColor : color

Die Farbe des Umgebungs- und Glanzlichts, definiert in Scene3D.


lightStrength : real

Die Stärke des Glanzlichts für das gesamte Diagramm. Der Wert muss zwischen 0.0 und 10.0 liegen.

Dieser Wert wirkt sich auf das in Scene3D angegebene Licht aus.


multiHighlightColor : color

Die Glanzlichtfarbe für ausgewählte Objekte. Wird verwendet, wenn bei selectionMode das Flag AbstractGraph3D.SelectionRow oder AbstractGraph3D.SelectionColumn gesetzt ist.

Hinweis: Transparenz wird nicht unterstützt und führt zu einem undefinierten Verhalten.


multiHighlightGradient : ColorGradient

Der Helligkeitsgradient für ausgewählte Objekte. Wird verwendet, wenn bei selectionMode das Flag AbstractGraph3D.SelectionRow oder AbstractGraph3D.SelectionColumn gesetzt ist.

Hinweis: Transparenz wird nicht unterstützt und führt zu undefiniertem Verhalten.


singleHighlightColor : color

Die Hervorhebungsfarbe für ein ausgewähltes Objekt. Wird verwendet, wenn auf selectionMode das Flag AbstractGraph3D.SelectionItem gesetzt ist.

Hinweis: Transparenz wird nicht unterstützt und führt zu einem undefinierten Verhalten.


singleHighlightGradient : ColorGradient

Der Hervorhebungsgradient für ein ausgewähltes Objekt. Wird verwendet, wenn bei selectionMode das Flag AbstractGraph3D.SelectionItem gesetzt ist.

Hinweis: Transparenz wird nicht unterstützt und führt zu einem undefinierten Verhalten.


type : Theme3D.Theme

Der Typ des Themas. Wenn kein Typ festgelegt ist, ist der Typ Theme3D.ThemeUserDefined. Wenn Sie den Thementyp ändern, nachdem das Element erstellt wurde, werden alle anderen Eigenschaften des Themas so geändert, wie es im vordefinierten Thema angegeben ist. Wird der Thementyp des aktiven Themas des Diagramms geändert, werden auch alle angehängten Reihen auf das neue Thema zurückgesetzt.


windowColor : color

Die Farbe des Anwendungsfensters, in das das Diagramm gezeichnet wird.


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