Surface3D QML Type
Beschreibt die Verwendung des 3D-Oberflächendiagramms. Mehr...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| Inherits: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- axisX : ValueAxis3D
- axisY : ValueAxis3D
- axisZ : ValueAxis3D
- flipHorizontalGrid : bool
(since QtDataVisualization 1.2) - selectedSeries : Surface3DSeries
- seriesList : list<Surface3DSeries>
Methoden
- void addSeries(Surface3DSeries series)
- void removeSeries(Surface3DSeries series)
Ausführliche Beschreibung
Dieser Typ ermöglicht es Entwicklern, Oberflächenplots in 3D mit „ Qt Quick “ darzustellen.
Um diesen Typ zu verwenden, müssen Sie das Datenvisualisierungsmodul importieren:
import QtDataVisualization 1.2Anschließend können Sie „Surface3D“ in Ihren QML-Dateien verwenden:
import QtQuick 2.0
import QtDataVisualization 1.2
Item {
width: 640
height: 480
Surface3D {
width: parent.width
height: parent.height
Surface3DSeries {
itemLabelFormat: "Pop density at (@xLabel N, @zLabel E): @yLabel"
ItemModelSurfaceDataProxy {
itemModel: dataModel
// Mapping model roles to surface series rows, columns, and values.
rowRole: "longitude"
columnRole: "latitude"
yPosRole: "pop_density"
}
}
}
ListModel {
id: dataModel
ListElement{ longitude: "20"; latitude: "10"; pop_density: "4.75"; }
ListElement{ longitude: "21"; latitude: "10"; pop_density: "3.00"; }
ListElement{ longitude: "22"; latitude: "10"; pop_density: "1.24"; }
ListElement{ longitude: "23"; latitude: "10"; pop_density: "2.53"; }
ListElement{ longitude: "20"; latitude: "11"; pop_density: "2.55"; }
ListElement{ longitude: "21"; latitude: "11"; pop_density: "2.03"; }
ListElement{ longitude: "22"; latitude: "11"; pop_density: "3.46"; }
ListElement{ longitude: "23"; latitude: "11"; pop_density: "5.12"; }
ListElement{ longitude: "20"; latitude: "12"; pop_density: "1.37"; }
ListElement{ longitude: "21"; latitude: "12"; pop_density: "2.98"; }
ListElement{ longitude: "22"; latitude: "12"; pop_density: "3.33"; }
ListElement{ longitude: "23"; latitude: "12"; pop_density: "3.23"; }
ListElement{ longitude: "20"; latitude: "13"; pop_density: "4.34"; }
ListElement{ longitude: "21"; latitude: "13"; pop_density: "3.54"; }
ListElement{ longitude: "22"; latitude: "13"; pop_density: "1.65"; }
ListElement{ longitude: "23"; latitude: "13"; pop_density: "2.67"; }
}
}Ausführlichere Anwendungsbeispiele finden Sie in der Surface-Graph-Galerie.
Siehe auch „ Surface3DSeries“ , „ ItemModelSurfaceDataProxy “, „ Bars3D “, „ Scatter3D “ und Qt Data Visualization C++ Classes.
Dokumentation zu den Eigenschaften
axisX : ValueAxis3D
Die aktive x-Achse.
Wird keine Achse angegeben, wird eine temporäre Standardachse ohne Beschriftungen und mit einem sich automatisch anpassenden Bereich erstellt. Diese temporäre Achse wird gelöscht, wenn eine andere Achse explizit mit derselben Ausrichtung festgelegt wird.
axisY : ValueAxis3D
Die aktive y-Achse.
Wird keine Achse angegeben, wird eine temporäre Standardachse ohne Beschriftungen und mit einem sich automatisch anpassenden Bereich erstellt. Diese temporäre Achse wird gelöscht, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.
axisZ : ValueAxis3D
Die aktive Z-Achse.
Wird keine Achse angegeben, wird eine temporäre Standardachse ohne Beschriftung und mit automatisch angepasstem Bereich erstellt. Diese temporäre Achse wird gelöscht, wenn eine andere Achse explizit auf dieselbe Ausrichtung festgelegt wird.
flipHorizontalGrid : bool [since QtDataVisualization 1.2]
In einigen Anwendungsfällen wird das Raster der horizontalen Achse größtenteils von der Oberfläche überdeckt, sodass es sinnvoller sein kann, das Raster der horizontalen Achse oberhalb des Diagramms statt darunter anzuzeigen. Ein typischer Anwendungsfall hierfür ist die Darstellung von 2D-Spektrogrammen unter Verwendung einer orthografischen Projektion mit einer Blickrichtung von oben nach unten.
Wenn „ false “ gesetzt ist, werden das horizontale Achsenraster und die Beschriftungen auf dem horizontalen Hintergrund des Diagramms gezeichnet. Wenn „ true “ gesetzt ist, werden das horizontale Achsenraster und die Beschriftungen auf der dem horizontalen Hintergrund gegenüberliegenden Seite des Diagramms gezeichnet. Der Standardwert ist „ false “.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
selectedSeries : Surface3DSeries
Die ausgewählte Serie oder null. Wenn für „ selectionMode “ das Flag „ SelectionMultiSeries “ gesetzt ist, enthält diese Eigenschaft die Serie, zu der der ausgewählte Punkt gehört.
seriesList : list<Surface3DSeries> [default]
Diese Eigenschaft enthält die Reihen des Diagramms. Standardmäßig enthält diese Eigenschaft eine leere Liste. Um die Reihen festzulegen, verwenden Sie entweder die Funktion „ addSeries()“ oder definieren Sie sie als untergeordnete Elemente des Diagramms.
Methodendokumentation
void addSeries(Surface3DSeries series)
Fügt den „ series “ zum Diagramm hinzu.
Siehe auch AbstractGraph3D::hasSeries().
void removeSeries(Surface3DSeries series)
Entfernt den „ series “ aus dem Diagramm.
Siehe auch „ AbstractGraph3D::hasSeries()“.
© 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.