Bar3DSeries QML Type (Uncreatable)
Stellt eine Datenreihe in einem 3D-Balkendiagramm dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QBar3DSeries |
| Inherits: |
Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Bar3DSeries ist Teil von „Qt Graphs “ – QML-Typen für 3D.
Eigenschaften
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- columnLabels : list
- dataArray : BarDataArray
- dataProxy : BarDataProxy
- invalidSelectionPosition : point
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- lightingMode : Abstract3DSeries.LightingMode
(since 6.10) - mesh : Abstract3DSeries.Mesh
- meshAngle : real
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- rowColors : list<Color>
- rowLabels : list
- selectedBar : point
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
Signale
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- columnLabelsChanged()
- dataArrayChanged(BarDataArray array)
- dataProxyChanged(BarDataProxy proxy)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
(since 6.10) - meshAngleChanged(real angle)
- meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- rowColorsChanged(list<color> rowcolors)
- rowLabelsChanged()
- selectedBarChanged(point position)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
Methoden
- void setMeshAxisAndAngle(vector3d axis, real angle)
Ausführliche Beschreibung
Dieser Typ verwaltet die serienspezifischen visuellen Elemente sowie die Seriendaten (über einen Datenproxy).
Bar3DSeries unterstützt die folgenden Format-Tags für „itemLabelFormat“:
| @rowTitle | Titel aus der Zeilenachse |
| @colTitle | Titel aus der Spaltenachse |
| @valueTitle | Titel der Werteachse |
| @rowIdx | Index der sichtbaren Zeile. Lokalisierung erfolgt anhand der Grafiklokalisierung. |
| @colIdx | Index der sichtbaren Spalte. Lokalisiert anhand der Graf-Lokalisierung. |
| @rowLabel | Beschriftung der Zeilenachse |
| @colLabel | Beschriftung der Spaltenachse |
| @valueLabel | Elementwert, formatiert gemäß dem Format der dem Diagramm zugeordneten Werteachse. Weitere Informationen finden Sie unter labelFormat. |
| @seriesName | Name der Reihe |
| %<Formatangabe> | Elementwert im angegebenen Format. Die Formatierung erfolgt nach denselben Regeln wie unter labelFormat beschrieben. |
Eine ausführlichere Beschreibung finden Sie unter QBar3DSeries.
Siehe auch Qt Graphs Datenverarbeitung mit 3D.
Eigenschaftsdokumentation
baseColor : color
Die Grundfarbe der Serie.
Siehe auch colorStyle und GraphsTheme.seriesColors.
baseGradient : Gradient
Der Basisgradient der Reihe.
Siehe auch colorStyle.
colorStyle : GraphsTheme.ColorStyle
Der Farbstil der Serie.
Siehe auch GraphsTheme.ColorStyle.
columnLabels : list
Die optionalen Spaltenbezeichnungen für das Array. Die Indizes in diesem Array entsprechen den Spaltenindizes in den Zeilen. Ist die Liste kürzer als die längste Zeile, erhalten nicht alle Spalten eine Bezeichnung.
dataArray : BarDataArray
Enthält die Referenz auf das Datenarray.
dataArrayChanged Ein Signal wird ausgelöst, wenn das Datenarray festgelegt wird, es sei denn, „ newDataArray “ ist identisch mit dem vorherigen.
Hinweis: Bevor irgendwelche Aktionen in Bezug auf das „dataArray“ durchgeführt werden, muss für den entsprechenden Proxy eine Serie angelegt werden.
dataProxy : BarDataProxy
Der aktive Datenproxy. Die Reihe übernimmt die Eigentumsrechte an jedem ihr zugewiesenen Proxy und löscht alle zuvor zugewiesenen Proxys, sobald ein neuer hinzugefügt wird. Der Proxy darf weder null sein noch auf eine andere Reihe gesetzt sein.
invalidSelectionPosition : point [read-only]
Eine Konstante, die eine ungültige Position für die Auswahl angibt. Diese Position wird der Eigenschaft „ selectedBar “ zugewiesen, um die Auswahl aus dieser Serie zu löschen.
Siehe auch „ GraphsItem3D.clearSelection()“.
itemLabel : string [read-only]
Die formatierte Bezeichnung des Elements. Wenn kein Element ausgewählt ist oder das ausgewählte Element nicht sichtbar ist, wird eine leere Zeichenkette zurückgegeben.
Siehe auch „ itemLabelFormat “.
itemLabelFormat : string
Das Beschriftungsformat für Datenelemente in dieser Reihe. Dieses Format wird für Einzelelement-Beschriftungen verwendet, beispielsweise wenn ein Element ausgewählt wird. Wie das Format interpretiert wird, hängt vom Reihentyp ab.
Siehe auch Bar3DSeries, Scatter3DSeries und Surface3DSeries.
itemLabelVisible : bool
Wenn „ true “ gesetzt ist, werden die Elementbeschriftungen als schwebende Beschriftungen im Diagramm dargestellt. Andernfalls werden die Elementbeschriftungen nicht angezeigt. Um die Elementbeschriftung in einem externen Steuerelement anzuzeigen, wird diese Eigenschaft auf „ false “ gesetzt. Die Standardeinstellung ist „ true “.
Siehe auch „ itemLabelFormat “ und „ itemLabel “.
lightingMode : Abstract3DSeries.LightingMode [since 6.10]
Der Beleuchtungsmodus der Elemente in der Serie. Der Standardwert lautet QAbstract3DSeries::LightingMode::Shaded
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
Siehe auch QAbstract3DSeries::LightingMode.
mesh : Abstract3DSeries.Mesh
Das Gitter der Elemente in der Serie oder der Auswahlzeiger im Fall von Surface3DSeries. Wenn das Gitter Abstract3DSeries.Mesh.UserDefined ist, muss zusätzlich die Eigenschaft userDefinedMesh festgelegt werden, damit die Elemente korrekt gerendert werden. Der Standardwert hängt vom Diagrammtyp ab.
Siehe auch QAbstract3DSeries::Mesh.
meshAngle : real
Eine Hilfsgröße zur Festlegung des Drehwinkels der Serie in Grad.
Hinweis: Beim Auslesen dieser Eigenschaft wird der Wert anhand des Werts „ Abstract3DSeries.meshRotation “ mit Gleitkommagenauigkeit berechnet und gibt stets einen Wert zwischen null und 360 Grad zurück.
Siehe auch „ Abstract3DSeries.meshRotation “.
meshRotation : quaternion
Die Mesh-Drehung, die auf alle Elemente der Serie angewendet wird. Die Drehung sollte ein normalisiertes Quaternion sein. Bei Serientypen, die elementspezifische Drehungen unterstützen, werden die Drehungen miteinander multipliziert. „ Bar3DSeries “ ignoriert alle Drehungen, die nicht um die y-Achse erfolgen. „ Surface3DSeries “ wendet die Drehung nur auf den Auswahlzeiger an. Standardmäßig erfolgt keine Drehung.
meshSmooth : bool
Wenn „ true “ eingestellt ist, werden geglättete Versionen vordefinierter Gitter verwendet, die über die Eigenschaft „ mesh “ festgelegt wurden. Diese Eigenschaft hat keine Auswirkungen auf benutzerdefinierte Gitter, die verwendet werden, wenn die Gitterart auf „ Abstract3DSeries.Mesh.UserDefined “ gesetzt ist. Der Standardwert ist „ false “.
multiHighlightColor : color
Die Hervorhebungsfarbe für mehrere Elemente der Serie.
Siehe auch colorStyle und GraphsTheme.multiHighlightColor.
multiHighlightGradient : Gradient
Der Farbverlauf zur Hervorhebung mehrerer Elemente in der Serie.
Siehe auch colorStyle und GraphsTheme.multiHighlightGradient.
name : string
Der Serienname. Er kann im Format einer Artikelbezeichnung mit dem Tag @seriesName verwendet werden.
Siehe auch itemLabelFormat.
rowColors : list<Color>
Mit dieser Eigenschaft können die Zeilen der Serie in verschiedenen Farben dargestellt werden. Um diese Eigenschaft nutzen zu können, muss die Eigenschaft „ GraphsTheme.colorStyle “ auf „ Uniform “ gesetzt sein.
Hinweis: Wenn die Eigenschaft festgelegt ist und das Design geändert wird, wird die Liste „rowColors“ nicht automatisch gelöscht.
Siehe auch „ QGraphsTheme::ColorStyle::Uniform “.
rowLabels : list
Die optionalen Zeilenbezeichnungen für das Array. Die Indizes in diesem Array entsprechen den Zeilenindizes im Daten-Array. Ist die Liste kürzer als die Anzahl der Zeilen, erhalten nicht alle Zeilen eine Bezeichnung.
selectedBar : point
Der ausgewählte Balken in der Reihe.
Die Position des ausgewählten Balkens wird als Zeile und Spalte im Datenarray der Reihe angegeben.
Es kann jeweils nur ein Balken ausgewählt werden.
Um die Auswahl in dieser Reihe aufzuheben, weisen Sie der Position den Wert „ invalidSelectionPosition “ zu.
Wird diese Reihe zu einem Diagramm hinzugefügt, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder die Auswahl aufheben, wenn sie ungültig wird. Die Auswahl eines Balkens in einer anderen hinzugefügten Reihe hebt die Auswahl ebenfalls auf.
Das Entfernen oder Einfügen von Zeilen in die Reihe vor der Zeile des ausgewählten Balkens passt die Auswahl so an, dass derselbe Balken ausgewählt bleibt.
Siehe auch ` GraphsItem3D.clearSelection()`.
singleHighlightColor : color
Die Highlight-Farbe für einzelne Artikel der Serie.
Siehe auch colorStyle und GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient
Das Highlight der Serie: ein einzelnes Produkt mit Farbverlauf.
Siehe auch colorStyle und GraphsTheme.singleHighlightGradient.
type : Abstract3DSeries.SeriesType [read-only]
Der Typ der Reihe. Einer der Werte aus „ QAbstract3DSeries::SeriesType “.
userDefinedMesh : string
Der Dateiname für ein benutzerdefiniertes Netz für Objekte, das bei „ mesh “ verwendet wird, lautet „ Abstract3DSeries.Mesh.UserDefined “.
Hinweis: Die Datei muss im „ QtQuick3D “-Netzformat vorliegen. Verwenden Sie das Konvertierungstool „ balsam “, um ein Netz aus anderen 3D-Modellformaten zu erstellen.
visible : bool
Die Sichtbarkeit der Reihe. Wenn „ false “ gilt, wird die Reihe nicht dargestellt.
Signal-Dokumentation
baseColorChanged(color color)
Dieses Signal wird ausgelöst, wenn sich „ baseColor “ in „ color “ ändert.
Hinweis: Der zugehörige Handler lautet onBaseColorChanged.
baseGradientChanged(Gradient gradient)
Dieses Signal wird ausgelöst, wenn sich „ baseGradient “ in „ gradient “ ändert.
Hinweis: Der entsprechende Handler lautet onBaseGradientChanged.
colorStyleChanged(GraphsTheme.ColorStyle style)
Dieses Signal wird ausgelöst, wenn sich colorStyle in style ändert.
Hinweis: Der entsprechende Handler lautet onColorStyleChanged.
columnLabelsChanged()
Dieses Signal wird ausgelöst, wenn sich Spaltenbezeichnungen ändern.
Hinweis: Der entsprechende Handler lautet „ onColumnLabelsChanged “.
dataArrayChanged(BarDataArray array)
Dieses Signal wird ausgelöst, wenn sich „ dataArray “ in „ array “ ändert.
Hinweis: Der entsprechende Handler lautet onDataArrayChanged.
dataProxyChanged(BarDataProxy proxy)
Dieses Signal wird ausgelöst, wenn sich dataProxy in proxy ändert.
Hinweis: Der entsprechende Handler ist onDataProxyChanged.
itemLabelChanged(string label)
Dieses Signal wird ausgelöst, wenn sich „ itemLabel “ in „ label “ ändert.
Hinweis: Der entsprechende Handler lautet onItemLabelChanged.
itemLabelFormatChanged(string format)
Dieses Signal wird ausgelöst, wenn sich „ itemLabelFormat “ in „ format “ ändert.
Hinweis: Der entsprechende Handler lautet onItemLabelFormatChanged.
itemLabelVisibilityChanged(bool visible)
Dieses Signal wird ausgelöst, wenn sich „itemLabelVisibility“ auf „ visible “ ändert.
Hinweis: Der entsprechende Handler lautet „ onItemLabelVisibilityChanged “.
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
Dieses Signal wird ausgelöst, wenn sich „ lightingMode “ in „ lightingMode “ ändert.
Hinweis: Der entsprechende Handler lautet „ onLightingModeChanged “.
Dieses Signal wurde in Qt 6.10 eingeführt.
meshAngleChanged(real angle)
Dieses Signal wird ausgelöst, wenn sich meshAngle in angle ändert.
Hinweis: Der entsprechende Handler lautet onMeshAngleChanged.
meshChanged(Abstract3DSeries.Mesh mesh)
Dieses Signal wird ausgelöst, wenn sich „ mesh “ in „ mesh “ ändert.
Hinweis: Der zugehörige Handler lautet onMeshChanged.
meshRotationChanged(quaternion rotation)
Dieses Signal wird ausgelöst, wenn sich „ meshRotation “ in „ rotation “ ändert.
Hinweis: Der entsprechende Handler lautet onMeshRotationChanged.
meshSmoothChanged(bool enabled)
Dieses Signal wird ausgelöst, wenn sich „ meshSmooth “ in „ enabled “ ändert.
Hinweis: Der entsprechende Handler lautet onMeshSmoothChanged.
multiHighlightColorChanged(color color)
Dieses Signal wird ausgelöst, wenn sich „ multiHighlightColor “ in „ color “ ändert.
Hinweis: Der zugehörige Handler lautet onMultiHighlightColorChanged.
multiHighlightGradientChanged(Gradient gradient)
Dieses Signal wird ausgelöst, wenn sich multiHighlightGradient in gradient ändert.
Hinweis: Der entsprechende Handler lautet onMultiHighlightGradientChanged.
nameChanged(string name)
Dieses Signal wird ausgelöst, wenn sich „ name “ in „ name “ ändert.
Hinweis: Der entsprechende Handler lautet onNameChanged.
rowColorsChanged(list<color> rowcolors)
Dieses Signal wird ausgelöst, wenn sich „ rowColors “ in „ rowcolors “ ändert.
Hinweis: Der entsprechende Handler lautet onRowColorsChanged.
rowLabelsChanged()
Dieses Signal wird ausgelöst, wenn sich Zeilenbezeichnungen ändern.
Hinweis: Der entsprechende Handler lautet onRowLabelsChanged.
selectedBarChanged(point position)
Dieses Signal wird ausgelöst, wenn sich „ selectedBar “ in „ position “ ändert.
Hinweis: Der entsprechende Handler lautet onSelectedBarChanged.
singleHighlightColorChanged(color color)
Dieses Signal wird ausgelöst, wenn sich „ singleHighlightColor “ in „ color “ ändert.
Hinweis: Der zugehörige Handler lautet onSingleHighlightColorChanged.
singleHighlightGradientChanged(Gradient gradient)
Dieses Signal wird ausgelöst, wenn sich „ singleHighlightGradient “ in „ gradient “ ändert.
Hinweis: Der entsprechende Handler lautet onSingleHighlightGradientChanged.
userDefinedMeshChanged(string fileName)
Dieses Signal wird ausgelöst, wenn sich „ userDefinedMesh “ in „ fileName “ ändert.
Hinweis: Der entsprechende Handler lautet onUserDefinedMeshChanged.
visibilityChanged(bool visible)
Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit der Serie auf „ visible “ ändert.
Hinweis: Der entsprechende Handler lautet „ onVisibilityChanged “.
Methodendokumentation
void setMeshAxisAndAngle(vector3d axis, real angle)
Eine Hilfsfunktion zum Erstellen eines Mesh-Rotationsquaternions auf der Grundlage von axis und angle.
Siehe auch meshRotation.
© 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.
