Scatter3DSeries QML Type (Uncreatable)
Stellt eine Datenreihe in einem 3D-Streudiagramm dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QScatter3DSeries |
| Inherits: | |
| Inherited By: |
Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- „Scatter3DSeries“ ist Teil der „Qt Graphs “ QML-Typen für 3D.
Eigenschaften
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- dataArray : ScatterDataArray
- dataProxy : ScatterDataProxy
- invalidSelectionIndex : qsizetype
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- itemSize : real
- lightingMode : Abstract3DSeries.LightingMode
(since 6.10) - mesh : Abstract3DSeries.Mesh
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- selectedItem : qsizetype
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
Signale
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- dataArrayChanged(ScatterDataArray array)
- dataProxyChanged(ScatterDataProxy proxy)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- itemSizeChanged(float size)
- lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
(since 6.10) - meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- selectedItemChanged(qsizetype index)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- splineColorChanged(color color)
- splineKnottingChanged(real knotting)
- splineLoopingChanged(bool looping)
- splineResolutionChanged(int resolution)
- splineTensionChanged(real tension)
- splineVisibilityChanged(bool visible)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
Methoden
- void setMeshAxisAndAngle(vector3d axis, real angle)
Ausführliche Beschreibung
Dieser Typ verwaltet sowohl die serienspezifischen visuellen Elemente als auch die Seriendaten (über einen Datenproxy).
Scatter3DSeries unterstützt die folgenden Format-Tags für „itemLabelFormat“:
| @xTitle | Titel der x-Achse |
| @yTitle | Titel von der y-Achse |
| @zTitle | Titel von der z-Achse |
| @xLabel | Der Wert des Elements wird im Format der x-Achse dargestellt. Weitere Informationen finden Sie unter labelFormat. |
| @yLabel | Elementwert, formatiert gemäß dem Format der y-Achse. Weitere Informationen finden Sie unter labelFormat. |
| @zLabel | Der Wert des Elements wird im Format der z-Achse formatiert. Weitere Informationen finden Sie unter labelFormat. |
| @seriesName | Name der Reihe |
Eine ausführlichere Beschreibung finden Sie unter QScatter3DSeries.
Siehe auch Qt Graphs Datenverarbeitung mit 3D.
Dokumentation zu den Eigenschaften
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.
dataArray : ScatterDataArray
Enthält den Verweis auf das Datenarray.
dataArrayChanged Das Signal wird ausgelöst, wenn das Datenarray gesetzt wird, es sei denn, „ newDataArray “ ist identisch mit dem vorherigen.
Hinweis: Bevor irgendwelche Aktionen in Bezug auf das Datenarray durchgeführt werden, muss für den entsprechenden Proxy eine Serie angelegt werden.
dataProxy : ScatterDataProxy
Legt den aktiven Datenproxy fest. Die Reihe übernimmt die Verantwortung für jeden ihr zugewiesenen Proxy und löscht alle zuvor festgelegten Proxys, sobald ein neuer hinzugefügt wird. Der Proxy darf weder null sein noch auf eine andere Reihe gesetzt sein.
invalidSelectionIndex : qsizetype
Eine Konstante, die einen ungültigen Index für die Auswahl bereitstellt. Dieser Index wird der Eigenschaft „ selectedItem “ zugewiesen, um die Auswahl aus dieser Reihe 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 Einzelelementbeschriftungen verwendet, beispielsweise wenn ein Element ausgewählt wird. Wie das Format interpretiert wird, hängt vom Reihen-Typ ab.
Siehe auch Bar3DSeries, Scatter3DSeries und Surface3DSeries.
itemLabelVisible : bool
Wenn „ true “ eingestellt 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 “.
itemSize : real
Legt die Elementgröße für die Reihe fest. Die Größe muss zwischen 0.0 und 1.0 liegen. Wenn die Größe auf 0.0 gesetzt wird, wird die Elementgröße automatisch anhand der Gesamtzahl der Elemente in allen Reihen des Diagramms skaliert. Die voreingestellte Standardgröße ist 0.0.
lightingMode : Abstract3DSeries.LightingMode [since 6.10]
Der Beleuchtungsmodus der Elemente in der Reihe. Der Standardwert lautet 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 Fall von Surface3DSeries. Wenn das Mesh Abstract3DSeries.Mesh.UserDefined ist, muss zusätzlich die Eigenschaft userDefinedMesh gesetzt werden, damit die Elemente korrekt gerendert werden. Der Standardwert hängt vom Diagrammtyp ab.
Siehe auch QAbstract3DSeries::Mesh.
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 Gitteroption auf „ Abstract3DSeries.Mesh.UserDefined “ gesetzt ist. Die Standardeinstellung 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 Name der Serie. Er kann im Format einer Artikelbezeichnung mit dem Tag „ @seriesName “ verwendet werden.
Siehe auch „ itemLabelFormat “.
selectedItem : qsizetype
Das Element, das am Index im Datenarray der Serie ausgewählt ist. Es kann jeweils nur ein Element ausgewählt sein. Um die Auswahl aus dieser Serie zu löschen, wird der Wert „ invalidSelectionIndex “ als Index festgelegt. Wenn diese Serie zu einem Diagramm hinzugefügt wird, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder die Auswahl aufheben, falls sie ungültig wird. Die Auswahl eines Elements in einer anderen hinzugefügten Reihe löscht ebenfalls die Auswahl. Das Entfernen oder Einfügen von Elementen in der Reihe vor dem ausgewählten Element passt die Auswahl so an, dass dasselbe Element 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: der Farbverlauf bei einem einzelnen Artikel.
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 der Verwendung von „ 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 entsprechende 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.
dataArrayChanged(ScatterDataArray array)
Dieses Signal wird ausgelöst, wenn sich dataArray in array ändert.
Hinweis: Der entsprechende Handler lautet onDataArrayChanged.
dataProxyChanged(ScatterDataProxy proxy)
Dieses Signal wird ausgelöst, wenn sich „ dataProxy “ in „ proxy “ ändert.
Hinweis: Der entsprechende Handler lautet 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 “.
itemSizeChanged(float size)
Dieses Signal wird ausgelöst, wenn sich itemSize in size ändert.
Hinweis: Der entsprechende Handler lautet onItemSizeChanged.
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
Dieses Signal wird ausgelöst, wenn sich lightingMode in lightingMode ändert.
Hinweis: Der zugehörige Handler lautet „ onLightingModeChanged “.
Dieses Signal wurde in Qt 6.10 eingeführt.
meshChanged(Abstract3DSeries.Mesh mesh)
Dieses Signal wird ausgelöst, wenn sich „ mesh “ in „ mesh “ ändert.
Hinweis: Der entsprechende 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 entsprechende 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.
selectedItemChanged(qsizetype index)
Dieses Signal wird ausgelöst, wenn sich „ selectedItem “ in „ index “ ändert.
Hinweis: Der entsprechende Handler lautet onSelectedItemChanged.
singleHighlightColorChanged(color color)
Dieses Signal wird ausgelöst, wenn sich „ singleHighlightColor “ in „ color “ ändert.
Hinweis: Der entsprechende Handler lautet onSingleHighlightColorChanged.
singleHighlightGradientChanged(Gradient gradient)
Dieses Signal wird ausgelöst, wenn sich singleHighlightGradient in gradient ändert.
Hinweis: Der zugehörige Handler lautet onSingleHighlightGradientChanged.
splineColorChanged(color color)
Dieses Signal wird ausgelöst, wenn sich splineColor auf color ändert.
Hinweis: Der entsprechende Handler lautet „ onSplineColorChanged “.
splineKnottingChanged(real knotting)
Dieses Signal wird ausgelöst, wenn sich „splineKnotting“ auf „ knotting “ ändert.
Hinweis: Der entsprechende Handler lautet „ onSplineKnottingChanged “.
splineLoopingChanged(bool looping)
Dieses Signal wird ausgelöst, wenn sich „splineLooping“ auf „ looping “ ändert.
Hinweis: Der entsprechende Handler lautet „ onSplineLoopingChanged “.
splineResolutionChanged(int resolution)
Dieses Signal wird ausgelöst, wenn sich `splineResolution` auf ` resolution` ändert.
Hinweis: Der entsprechende Handler lautet „ onSplineResolutionChanged “.
splineTensionChanged(real tension)
Dieses Signal wird ausgelöst, wenn sich splineTension auf tension ändert.
Hinweis: Der entsprechende Handler ist „ onSplineTensionChanged “.
splineVisibilityChanged(bool visible)
Dieses Signal wird ausgelöst, wenn sich der Wert von „splineVisible“ auf „ visible “ ändert.
Hinweis: Der entsprechende Handler lautet „ onSplineVisibilityChanged “.
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 anhand 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.
