本页内容

Scatter3D QML Type

3D散点图。更多...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
Inherits:

AbstractGraph3D

Status: Deprecated

此类型已弃用。我们强烈建议不要在新代码中使用它。

属性

方法

详细说明

此类型允许开发人员使用Qt Quick 渲染3D散点图。

要使用此类型,您需要导入数据可视化模块:

import QtDataVisualization 1.2

之后,您可以在 QML 文件中使用 Scatter3D:

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Scatter3D {
        width: parent.width
        height: parent.height
        Scatter3DSeries {
            ItemModelScatterDataProxy {
                itemModel: dataModel
                // Mapping model roles to scatter series item coordinates.
                xPosRole: "xPos"
                yPosRole: "yPos"
                zPosRole: "zPos"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ xPos: "2.754"; yPos: "1.455"; zPos: "3.362"; }
        ListElement{ xPos: "3.164"; yPos: "2.022"; zPos: "4.348"; }
        ListElement{ xPos: "4.564"; yPos: "1.865"; zPos: "1.346"; }
        ListElement{ xPos: "1.068"; yPos: "1.224"; zPos: "2.983"; }
        ListElement{ xPos: "2.323"; yPos: "2.502"; zPos: "3.133"; }
    }
}

请参阅《简单的散点图》以获取更详细的使用示例。

另请参阅 Scatter3DSeries 、ScatterDataProxy 、Bars3D 、Surface3D 以及 Qt Data Visualization C++ Classes。

属性文档

axisX : ValueAxis3D

活动 x 轴。

如果未指定坐标轴,系统将创建一个临时默认坐标轴,该坐标轴无标签且范围会自动调整。如果显式将另一个坐标轴设置为相同的取向,则该临时坐标轴将被销毁。

axisY : ValueAxis3D

活动 y 轴。

如果未指定坐标轴,系统将创建一个临时默认坐标轴,该坐标轴无标签且范围会自动调整。如果显式将另一个坐标轴设置为相同的取向,则该临时坐标轴将被销毁。

axisZ : ValueAxis3D

当前活动的 Z 轴。

如果未指定坐标轴,系统将创建一个临时默认坐标轴,该坐标轴无标签且范围会自动调整。如果显式将另一个坐标轴设置为相同的取向,则该临时坐标轴将被销毁。

selectedSeries : Scatter3DSeries

所选系列或为空。

seriesList : list<Scatter3DSeries> [default]

该属性用于存储图表的系列。默认情况下,该属性包含一个空列表。要设置系列,可以使用addSeries()方法,或者将其定义为图表的子元素。

方法文档

void addSeries(Scatter3DSeries series)

将series 添加到图表中。一个图表可以包含多个系列,但只有一组坐标轴。如果新添加的系列指定了选定项,该项将被高亮显示,且任何现有的选定状态都将被清除。仅有一个添加的系列可以处于选定状态。

另请参阅 AbstractGraph3D::hasSeries()。

void removeSeries(Scatter3DSeries series)

从图中移除series 。

另请参阅 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.