Theme3D QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• ambientLightStrength : real
• backgroundColor : color
• backgroundEnabled : bool
• baseColors : list<ThemeColor>
• baseGradients : list<ColorGradient>
• colorStyle : Theme3D.ColorStyle
• font : font
• gridEnabled : bool
• gridLineColor : color
• highlightLightStrength : real
• labelBackgroundColor : color
• labelBackgroundEnabled : bool
• labelBorderEnabled : bool
• labelTextColor : color
• lightColor : color
• lightStrength : real
• multiHighlightColor : color
• multiHighlightGradient : ColorGradient
• singleHighlightColor : color
• singleHighlightGradient : ColorGradient
• type : Theme3D.Theme
• windowColor : color

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 der Eigenschaften 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.

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.

Dokumentation der Eigenschaften

ambientLightStrength : real

Die Umgebungslichtstärke für das gesamte Diagramm. 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, 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 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 Basisgradienten, 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 Aufzählungswerte.

Dieser Wert kann durch die explizite Angabe von Abstract3DSeries.colorStyle in der Serie außer Kraft gesetzt 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 Gitterlinien.

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 Etikettenhintergründe. Hat keine Auswirkung, wenn labelBackgroundEnabled 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 Hintergrund werden auf der Grundlage der längsten Beschriftung gleich groß 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 gezeichnet werden, die einen Hintergrund haben. Hat keine Auswirkung, wenn labelBackgroundEnabled false ist.

labelTextColor : color

Die Farbe der für die Beschriftungen verwendeten Schrift.

lightColor : color

Die Farbe des Umgebungslichts und des spiegelnden Lichts, definiert in Scene3D.

lightStrength : real

Die Spiegelungslichtstärke 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 Markierungsfarbe für ausgewählte Objekte. Wird verwendet, wenn selectionMode das Flag AbstractGraph3D.SelectionRow oder AbstractGraph3D.SelectionColumn gesetzt hat.

multiHighlightGradient : ColorGradient

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

singleHighlightColor : color

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

singleHighlightGradient : ColorGradient

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

type : Theme3D.Theme

Der Typ des Themas. Wenn kein Typ festgelegt ist, lautet der Typ Theme3D.ThemeUserDefined. Wenn Sie den Thementyp ändern, nachdem das Element konstruiert wurde, werden alle anderen Eigenschaften des Themas so geändert, wie es das vordefinierte Thema vorgibt. Das Ändern des Thementyps des aktiven Themas des Diagramms setzt auch alle angehängten Serien zurück, um das neue Thema zu verwenden.

windowColor : color

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