Bar3DSeries QML Type
Stellt eine Datenreihe in einem 3D-Balkendiagramm dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QBar3DSeries |
| Inherits: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Bar3DSeries ist Teil von Qt Graphs QML Types for 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)
Detaillierte Beschreibung
Dieser Typ verwaltet die serienspezifischen visuellen Elemente, sowie die Seriendaten (über einen Daten-Proxy).
Bar3DSeries unterstützt die folgenden Format-Tags für itemLabelFormat:
| @rowTitle | Titel der Zeilenachse |
| @colTitle | Titel der Spaltenachse |
| @valueTitle | Titel aus der Wertachse |
| @rowIdx | Sichtbarer Zeilenindex. Lokalisiert unter Verwendung des Gebietsschemas der Grafik. |
| @colIdx | Sichtbarer Spaltenindex. Wird unter Verwendung des Diagrammgebietsschemas lokalisiert. |
| @rowLabel | Beschriftung der Zeilenachse |
| @colLabel | Label von der Spaltenachse |
| @valueLabel | Elementwert, formatiert unter Verwendung des Formats der dem Diagramm zugeordneten Wertachse. Für weitere Informationen, siehe labelFormat. |
| @Reihenname | Name der Reihe |
| %<Formatangabe> | Elementwert in dem angegebenen Format. Die Formatierung erfolgt nach denselben Regeln wie bei labelFormat. |
Eine ausführlichere Beschreibung finden Sie unter QBar3DSeries.
Siehe auch Qt Graphs Datenverarbeitung mit 3D.
Dokumentation der Eigenschaft
baseColor : color
Die Grundfarbe der Serie.
Siehe auch colorStyle und GraphsTheme.seriesColors.
baseGradient : Gradient
Die Basissteigung der Reihe.
Siehe auch colorStyle.
colorStyle : GraphsTheme.ColorStyle
Das Farbschema für die 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. Wenn die Liste kürzer ist als die längste Zeile, erhalten nicht alle Spalten Bezeichnungen.
dataArray : BarDataArray
Enthält den Verweis auf das Datenfeld.
dataArrayChanged Signal wird ausgegeben, wenn dataArray gesetzt wird, es sei denn, newDataArray ist mit dem vorherigen identisch.
Hinweis: Bevor irgendetwas in Bezug auf das dataArray getan wird, muss eine Serie für den entsprechenden Proxy erstellt werden.
dataProxy : BarDataProxy
Der aktive Daten-Proxy. Die Reihe übernimmt alle Proxys, die für sie festgelegt wurden, und löscht alle zuvor festgelegten Proxys, wenn ein neuer hinzugefügt wird. Der Proxy kann nicht ungültig oder auf eine andere Serie festgelegt sein.
invalidSelectionPosition : point [read-only]
Eine konstante Eigenschaft, die eine ungültige Position für die Auswahl angibt. Diese Position wird der Eigenschaft selectedBar zugewiesen, um die Auswahl aus dieser Reihe zu löschen.
Siehe auch GraphsItem3D.clearSelection().
itemLabel : string [read-only]
Die formatierte Bezeichnung des Elements. Wenn es kein ausgewähltes Element gibt oder das ausgewählte Element nicht sichtbar ist, wird ein leerer String zurückgegeben.
Siehe auch itemLabelFormat.
itemLabelFormat : string
Das Beschriftungsformat für Datenelemente in dieser Serie. Dieses Format wird für Beschriftungen einzelner Elemente verwendet, z. B. wenn ein Element ausgewählt wird. Wie das Format interpretiert wird, hängt vom Serientyp ab.
Siehe auch Bar3DSeries, Scatter3DSeries, und Surface3DSeries.
itemLabelVisible : bool
Wenn true, werden die Elementbeschriftungen als fließende Beschriftungen im Diagramm gezeichnet. Andernfalls werden die Elementbeschriftungen nicht gezeichnet. 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 ist QAbstract3DSeries::LightingMode::Shaded
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
Siehe auch QAbstract3DSeries::LightingMode.
mesh : Abstract3DSeries.Mesh
Das Mesh der Elemente in der Serie oder der Auswahlzeiger im Falle von Surface3DSeries. Wenn das Mesh Abstract3DSeries.Mesh.UserDefined ist, muss auch die Eigenschaft userDefinedMesh festgelegt werden, damit die Elemente richtig dargestellt werden. Der Standardwert hängt vom Diagrammtyp ab.
Siehe auch QAbstract3DSeries::Mesh.
meshAngle : real
Eine bequeme Eigenschaft zur Definition des Drehwinkels der Serie in Grad.
Hinweis: Beim Auslesen dieser Eigenschaft wird sie aus dem Wert Abstract3DSeries.meshRotation mit Fließkomma-Präzision berechnet und gibt immer einen Wert von null bis 360 Grad zurück.
Siehe auch Abstract3DSeries.meshRotation.
meshRotation : quaternion
Die Drehung des Netzes, die auf alle Elemente der Serie angewendet wird. Die Drehung sollte eine normalisierte Quaternion sein. Bei Serientypen, die eine objektspezifische Drehung unterstützen, werden die Drehungen miteinander multipliziert. Bar3DSeries ignoriert jede Drehung, die nicht um die y-Achse erfolgt. Surface3DSeries wendet die Drehung nur auf den Auswahlzeiger an. Standardmäßig ist keine Drehung vorgesehen.
meshSmooth : bool
Wenn true eingestellt ist, werden glatte Versionen von vordefinierten Meshes verwendet, die über die Eigenschaft mesh eingestellt sind. Diese Eigenschaft wirkt sich nicht auf benutzerdefinierte Meshes aus, die verwendet werden, wenn das Mesh auf Abstract3DSeries.Mesh.UserDefined eingestellt ist. Die Standardeinstellung ist false.
multiHighlightColor : color
Die Farbe der Hervorhebung mehrerer Elemente in der Serie.
Siehe auch colorStyle und GraphsTheme.multiHighlightColor.
multiHighlightGradient : Gradient
Der Hervorhebungsgradient für mehrere Elemente in der Serie.
Siehe auch colorStyle und GraphsTheme.multiHighlightGradient.
name : string
Der Name der Serie. Er kann im Format der Artikelbezeichnung mit dem Tag @seriesName verwendet werden.
Siehe auch itemLabelFormat.
rowColors : list<Color>
Diese Eigenschaft kann verwendet werden, um die Zeilen der Reihe in verschiedenen Farben zu zeichnen. Die GraphsTheme.colorStyle muss auf Uniform gesetzt sein, um diese Eigenschaft zu verwenden.
Hinweis: Wenn die Eigenschaft eingestellt ist und das Thema 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 Datenarray. Wenn die Liste kürzer ist als die Anzahl der Zeilen, erhalten nicht alle Zeilen Bezeichnungen.
selectedBar : point
Der ausgewählte Balken in der Reihe.
Die Position des ausgewählten Balkens wird als Zeile und Spalte im Datenfeld der Reihe angegeben.
Es kann jeweils nur ein Balken ausgewählt werden.
Um die Auswahl für diese Reihe aufzuheben, geben Sie als Position invalidSelectionPosition an.
Wenn diese Reihe zu einem Diagramm hinzugefügt wird, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder wenn sie ungültig wird. Wenn Sie einen Balken einer anderen hinzugefügten Reihe auswählen, wird die Auswahl ebenfalls gelöscht.
Das Entfernen von Zeilen aus der Reihe oder das 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 Farbe der Hervorhebung eines einzelnen Elements in der Serie.
Siehe auch colorStyle und GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient
Der Hervorhebungsgradient des einzelnen Elements der Serie.
Siehe auch colorStyle und GraphsTheme.singleHighlightGradient.
type : Abstract3DSeries.SeriesType [read-only]
Der Typ der Serie. Einer der Werte von QAbstract3DSeries::SeriesType.
userDefinedMesh : string
Der Dateiname für ein benutzerdefiniertes benutzerdefiniertes Mesh für Objekte, das bei mesh verwendet wird, lautet Abstract3DSeries.Mesh.UserDefined.
Hinweis: Die Datei muss im Mesh-Format QtQuick3D vorliegen. Verwenden Sie das Konvertierungswerkzeug balsam, um ein Netz aus anderen 3D-Modellformaten zu erstellen.
visible : bool
Die Sichtbarkeit der Serie. Wenn false, wird die Serie nicht angezeigt.
Signal Dokumentation
baseColorChanged(color color)
Dieses Signal wird ausgegeben, wenn baseColor zu color wechselt.
Hinweis: Der entsprechende Handler ist onBaseColorChanged.
baseGradientChanged(Gradient gradient)
Dieses Signal wird ausgegeben, wenn baseGradient zu gradient wechselt.
Hinweis: Der entsprechende Handler ist onBaseGradientChanged.
colorStyleChanged(GraphsTheme.ColorStyle style)
Dieses Signal wird ausgegeben, wenn colorStyle zu style wechselt.
Hinweis: Der entsprechende Handler ist onColorStyleChanged.
columnLabelsChanged()
Dieses Signal wird ausgegeben, wenn sich die Spaltenbezeichnungen ändern.
Hinweis: Der entsprechende Handler ist onColumnLabelsChanged.
dataArrayChanged(BarDataArray array)
Dieses Signal wird ausgegeben, wenn dataArray zu array wechselt.
Hinweis: Der entsprechende Handler ist onDataArrayChanged.
dataProxyChanged(BarDataProxy proxy)
Dieses Signal wird ausgegeben, wenn dataProxy zu proxy wechselt.
Hinweis: Der entsprechende Handler ist onDataProxyChanged.
itemLabelChanged(string label)
Dieses Signal wird ausgegeben, wenn itemLabel zu label wechselt.
Hinweis: Der entsprechende Handler ist onItemLabelChanged.
itemLabelFormatChanged(string format)
Dieses Signal wird ausgegeben, wenn itemLabelFormat zu format wechselt.
Hinweis: Der entsprechende Handler ist onItemLabelFormatChanged.
itemLabelVisibilityChanged(bool visible)
Dieses Signal wird ausgegeben, wenn itemLabelVisibility auf visible wechselt.
Hinweis: Der entsprechende Handler ist onItemLabelVisibilityChanged.
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
Dieses Signal wird ausgegeben, wenn lightingMode zu lightingMode wechselt.
Hinweis: Der entsprechende Handler ist onLightingModeChanged.
Dieses Signal wurde in Qt 6.10 eingeführt.
meshAngleChanged(real angle)
Dieses Signal wird ausgegeben, wenn meshAngle zu angle wechselt.
Hinweis: Der entsprechende Handler ist onMeshAngleChanged.
meshChanged(Abstract3DSeries.Mesh mesh)
Dieses Signal wird ausgegeben, wenn mesh zu mesh wechselt.
Hinweis: Der entsprechende Handler ist onMeshChanged.
meshRotationChanged(quaternion rotation)
Dieses Signal wird ausgegeben, wenn meshRotation zu rotation wechselt.
Hinweis: Der entsprechende Handler ist onMeshRotationChanged.
meshSmoothChanged(bool enabled)
Dieses Signal wird ausgegeben, wenn meshSmooth zu enabled wechselt.
Hinweis: Der entsprechende Handler ist onMeshSmoothChanged.
multiHighlightColorChanged(color color)
Dieses Signal wird ausgegeben, wenn multiHighlightColor zu color wechselt.
Hinweis: Der entsprechende Handler ist onMultiHighlightColorChanged.
multiHighlightGradientChanged(Gradient gradient)
Dieses Signal wird ausgegeben, wenn multiHighlightGradient zu gradient wechselt.
Hinweis: Der entsprechende Handler ist onMultiHighlightGradientChanged.
nameChanged(string name)
Dieses Signal wird ausgegeben, wenn name zu name wechselt.
Hinweis: Der entsprechende Handler ist onNameChanged.
rowColorsChanged(list<color> rowcolors)
Dieses Signal wird ausgegeben, wenn rowColors zu rowcolors wechselt.
Hinweis: Der entsprechende Handler ist onRowColorsChanged.
rowLabelsChanged()
Dieses Signal wird ausgegeben, wenn sich die Zeilenbeschriftungen ändern.
Hinweis: Der entsprechende Handler ist onRowLabelsChanged.
selectedBarChanged(point position)
Dieses Signal wird ausgegeben, wenn selectedBar zu position wechselt.
Hinweis: Der entsprechende Handler ist onSelectedBarChanged.
singleHighlightColorChanged(color color)
Dieses Signal wird ausgegeben, wenn singleHighlightColor zu color wechselt.
Hinweis: Der entsprechende Handler ist onSingleHighlightColorChanged.
singleHighlightGradientChanged(Gradient gradient)
Dieses Signal wird ausgegeben, wenn singleHighlightGradient zu gradient wechselt.
Hinweis: Der entsprechende Handler ist onSingleHighlightGradientChanged.
userDefinedMeshChanged(string fileName)
Dieses Signal wird ausgegeben, wenn userDefinedMesh zu fileName wechselt.
Hinweis: Der entsprechende Handler ist onUserDefinedMeshChanged.
visibilityChanged(bool visible)
Dieses Signal wird ausgegeben, wenn die Sichtbarkeit der Serie auf visible wechselt.
Hinweis: Der entsprechende Handler ist onVisibilityChanged.
Dokumentation der Methode
void setMeshAxisAndAngle(vector3d axis, real angle)
Eine praktische Funktion, um eine Netzrotationsquaternion aus axis und angle zu konstruieren.
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.
