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
- 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)
- 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 im 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.
Eigenschaft Dokumentation
baseColor : color |
Legt die Grundfarbe der Serie fest.
Siehe auch colorStyle und GraphsTheme.seriesColors.
baseGradient : Gradient |
Legt den Grundgradienten der Serie fest.
Siehe auch colorStyle und GraphsTheme.seriesGradients.
colorStyle : GraphsTheme.ColorStyle |
Legt den Farbstil für die Serie fest.
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 als die längste Zeile ist, erhalten nicht alle Spalten Beschriftungen.
dataArray : BarDataArray |
Hält den Verweis auf das Daten-Array.
dataArrayChanged Das Signal wird ausgegeben, wenn das Datenarray gesetzt wird, es sei denn, newDataArray ist identisch mit dem vorherigen Array.
Hinweis: Bevor irgendetwas in Bezug auf das dataArray getan wird, muss eine Reihe für den entsprechenden Proxy erstellt werden.
dataProxy : BarDataProxy |
Der aktive Daten-Proxy. Die Serie ü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 null sein oder auf eine andere Serie gesetzt werden.
invalidSelectionPosition : point |
Eine konstante Eigenschaft, die eine ungültige Position für die Auswahl bereitstellt. Diese Position wird der Eigenschaft selectedBar zugewiesen, um die Auswahl aus dieser Serie zu löschen.
Siehe auch GraphsItem3D.clearSelection().
itemLabel : string |
Die formatierte Bezeichnung des Elements. Wenn es kein ausgewähltes Element gibt oder das ausgewählte Element nicht sichtbar ist, wird eine leere Zeichenfolge zurückgegeben.
Siehe auch itemLabelFormat.
itemLabelFormat : string |
Das Beschriftungsformat für Datenelemente in dieser Reihe. Dieses Format wird für Beschriftungen einzelner Elemente verwendet, z. B. wenn ein Element ausgewählt ist. Wie das Format interpretiert wird, hängt vom Serientyp ab.
Siehe auch Bar3DSeries, Scatter3DSeries, und Surface3DSeries.
itemLabelVisible : bool |
Bei 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.
mesh : Abstract3DSeries.Mesh |
Legt das Netz der Elemente in der Serie fest, oder den Auswahlzeiger im Falle von Surface3DSeries. Wenn das Netz 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ßkommagenauigkeit berechnet und gibt immer einen Wert zwischen 0 und 360 Grad zurück.
Siehe auch Abstract3DSeries.meshRotation.
meshRotation : quaternion |
Legt die Netzdrehung fest, die auf alle Elemente der Serie angewendet wird. Die Drehung sollte ein normalisiertes Quaternion sein. Bei Serientypen, die objektspezifische Drehungen 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. Die Voreinstellung ist keine Drehung.
meshSmooth : bool |
Wenn true, werden glatte Versionen von vordefinierten Meshes verwendet, die über die Eigenschaft mesh festgelegt wurden. 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 |
Legt die Farbe für die Hervorhebung mehrerer Elemente in der Serie fest.
Siehe auch colorStyle und GraphsTheme.multiHighlightColor.
multiHighlightGradient : Gradient |
Legt den Farbverlauf für die Hervorhebung mehrerer Elemente in der Serie fest.
Siehe auch colorStyle und GraphsTheme.multiHighlightGradient.
name : string |
Der Name der Serie. Er kann im Artikelbeschriftungsformat mit dem Tag @seriesName verwendet werden.
Siehe auch itemLabelFormat.
rowColors : list<Color> |
Diese Eigenschaft kann verwendet werden, um die Zeilen der Serie in verschiedenen Farben zu zeichnen. Um diese Eigenschaft zu verwenden, muss GraphsTheme.colorStyle auf Uniform gesetzt werden.
Hinweis: Wenn die Eigenschaft gesetzt 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 stimmen mit den Zeilenindizes im Datenarray überein. Wenn die Liste kürzer ist als die Anzahl der Zeilen, erhalten nicht alle Zeilen Beschriftungen.
selectedBar : point |
Der ausgewählte Balken in der Reihe.
Die Position des ausgewählten Balkens wird als Zeile und Spalte im Daten-Array 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 |
Legt die Farbe für die Hervorhebung einzelner Elemente in der Reihe fest.
Siehe auch colorStyle und GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient |
Legt den Farbverlauf für die Hervorhebung eines einzelnen Elements in der Serie fest.
Siehe auch colorStyle und GraphsTheme.singleHighlightGradient.
type : Abstract3DSeries.SeriesType |
Der Typ der Serie. Einer der Werte von QAbstract3DSeries::SeriesType.
userDefinedMesh : string |
Legt den Dateinamen für ein benutzerdefiniertes benutzerdefiniertes Netz für Objekte fest, das verwendet wird, wenn mesh Abstract3DSeries.Mesh.UserDefined ist.
Hinweis: Die Datei muss im QtQuick3D Mesh-Format vorliegen. Verwenden Sie das Konvertierungstool balsam, um ein Netz aus anderen 3D-Modellformaten zu erstellen.
visible : bool |
Legt die Sichtbarkeit der Serie fest. Wenn false gewählt wird, wird die Serie nicht gerendert.
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 geändert wird.
Hinweis: Der entsprechende Handler ist onItemLabelVisibilityChanged.
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.
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 sich die Sichtbarkeit der Serie auf visible ändert.
Hinweis: Der entsprechende Handler ist onVisibilityChanged.
Dokumentation der Methode
Eine Komfortfunktion, um eine Maschenrotationsquaternion aus axis und angle zu konstruieren.
Siehe auch meshRotation.
© 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.
