Theme3D QML Type

Ein Darstellungsstil für Diagramme. Mehr...

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• 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

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.

Die folgenden Eigenschaften können überschrieben werden, indem die Eigenschaften „ Abstract3DSeries “ verwendet werden, um sie in den Reihen explizit festzulegen: „ baseColors “, „ baseGradients “ und „ colorStyle “.

Themen können mithilfe des Enum-Werts „ Theme3D.ThemeUserDefined “ von Grund auf neu erstellt werden.

Standard-Thema

Die folgende Tabelle listet die von Themen gesteuerten Eigenschaften sowie die Standardwerte für „ Theme3D.ThemeUserDefined “ auf.

Anwendungsbeispiele

Verwendung eines integrierten Themes ohne Änderungen:

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

Verwendung eines integrierten Themes mit einigen Anpassungen:

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

Verwendung eines benutzerdefinierten Themes:

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

Informationen zu den Theme3D-Enums finden Sie unter Q3DTheme::ColorStyle und Q3DTheme::Theme.

Dokumentation zu den Eigenschaften

ambientLightStrength : real

Die Umgebungshelligkeit für das gesamte Diagramm. Dieser Wert bestimmt, wie gleichmäßig und hell die Farben im gesamten Diagramm dargestellt werden, unabhängig von der Position der Lichtquelle. 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 Werts von „ backgroundColor “ gezeichnet wird.

baseColors : list<ThemeColor>

Die Liste der Grundfarben, 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 „ Theme3D.ColorStyleUniform “ gesetzt ist.

Dies kann durch die explizite Festlegung von ` Abstract3DSeries.baseColor ` in der jeweiligen Reihe überschrieben werden.

baseGradients : list<ColorGradient>

Die Liste der Basisgradienten, die für alle Objekte im Diagramm verwendet werden sollen, Reihe für Reihe. Wenn es mehr Reihen als Gradienten gibt, wird die Gradientenliste umgebrochen und beginnt erneut mit dem ersten Gradienten in der Liste.

Hat keine unmittelbare Auswirkung, wenn „ colorStyle “ auf „ Theme3D.ColorStyleUniform “ gesetzt ist.

Dieser Wert kann überschrieben werden, indem „ Abstract3DSeries.baseGradient “ in der jeweiligen Reihe explizit festgelegt wird.

colorStyle : Theme3D.ColorStyle

Der Stil der Diagrammfarben. Einer der Aufzählungswerte von „ Q3DTheme::ColorStyle “.

Dieser Wert kann überschrieben werden, indem „ Abstract3DSeries.colorStyle “ in der Reihe explizit festgelegt wird.

Siehe auch „ Q3DTheme::ColorStyle “.

font : font

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

gridEnabled : bool

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

gridLineColor : color

Die Farbe der Gitterlinien.

highlightLightStrength : real

Die Spiegelungshelligkeit für ausgewählte Objekte. Der Wert muss zwischen 0.0 und 10.0 liegen.

labelBackgroundColor : color

Die Farbe des Etikettenhintergrunds. Hat keine Auswirkung, wenn „ labelBackgroundEnabled “ auf „ false “ gesetzt 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 je nach Achse in gleicher Größe gezeichnet, wobei die längste Beschriftung als Maßstab dient, 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 für Beschriftungen mit Hintergrund Rahmen gezeichnet werden. Hat keine Auswirkung, wenn „ labelBackgroundEnabled “ auf „ false “ gesetzt ist.

labelTextColor : color

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

lightColor : color

Die Farbe des Umgebungslichts und des Spiegelungslichts, wie in Scene3D definiert.

lightStrength : real

Die Stärke des Spiegelungslichts für die gesamte Grafik. Der Wert muss zwischen 0.0 und 10.0 liegen.

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

multiHighlightColor : color

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

multiHighlightGradient : ColorGradient

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

singleHighlightColor : color

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

singleHighlightGradient : ColorGradient

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

type : Theme3D.Theme

Der Typ des Themas. Wenn kein Typ festgelegt ist, lautet der Typ „ Theme3D.ThemeUserDefined “. Wird der Thementyp nach der Erstellung des Elements geändert, werden alle anderen Eigenschaften des Themas auf die Werte angepasst, die im vordefinierten Thema festgelegt sind. Durch Ändern des Thementyps des aktiven Themas des Diagramms werden außerdem alle zugehörigen Reihen zurückgesetzt, sodass sie das neue Thema verwenden.

windowColor : color

Die Farbe des Anwendungsfensters, in dem die Grafik angezeigt wird.