Bars3D QML 类型

3D 条形图。更多...

导入语句	import QtDataVisualization 1.7
自	QtDataVisualization 1.0
继承	AbstractGraph3D

包含所有成员（包括继承成员）的列表

属性属性

barSeriesMargin : size (since 6.3)
barSpacing : size
barSpacingRelative : bool
barThickness : real
columnAxis : CategoryAxis3D
floorLevel : real
multiSeriesUniform : bool
primarySeries : Bar3DSeries
rowAxis : CategoryAxis3D
selectedSeries : Bar3DSeries
seriesList : list<Bar3DSeries>
valueAxis : ValueAxis3D

方法方法

void addSeries(Bar3DSeries series)
void insertSeries(int index, Bar3DSeries series)
void removeSeries(Bar3DSeries series)

详细描述详细描述

此类型允许开发者在 Qt Quick 中渲染 3D 条形图。

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

import QtDataVisualization 1.2

然后您可以在您的 qml 文件中使用 Bars3D

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Bars3D {
        width: parent.width
        height: parent.height

        Bar3DSeries {
            itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"

            ItemModelBarDataProxy {
                itemModel: dataModel
                // Mapping model roles to bar series rows, columns, and values.
                rowRole: "year"
                columnRole: "city"
                valueRole: "expenses"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ year: "2012"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2012"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2012"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2012"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2013"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2013"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2013"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2013"; city: "Tampere";  expenses: "4650"; }
    }
}

有关更详细的用法示例，请参阅简单的条形图。

另请参阅 Bar3DSeries、ItemModelBarDataProxy、Scatter3D、Surface3D 和 Qt 数据可视化 C++ 类。

属性文档

barSeriesMargin : size [since 6.3]

X 和 Z 维度内系列列之间的空白。默认预设为 (0.0, 0.0)。合理的值在范围 [0,1) 内。

此属性自 Qt 6.3 开始引入。

barSpacing : size

XY 和 Z 维度内的条形间距。

默认预设为 (1.0, 1.0)。间隔间距受 barSpacingRelative 属性影响。

barSpacingRelative : bool

间隔是绝对间隔还是相对于柱条厚度。

如果设置为 true，则 0.0 的值表示柱条紧挨放置，1.0 表示在柱条之间留有与柱条厚度相同的间隔，依此类推。预设为 true。

barThickness : real

柱条在 X 和 Z 维度之间的厚度比例。值 1.0 表示柱条宽度等于其深度，而 0.5 使柱条深度是其宽度的两倍。

columnAxis : CategoryAxis3D

活动列轴。

如果没有指定轴，将创建一个没有标签的临时默认轴。如果显式地将另一个轴设置为相同的方向，则此临时轴将被销毁。

floorLevel : real

在 Y 轴数据坐标中条形图的地板水平。

实际的地板水平将由 Y 轴的最小值和最大值限制。默认为零。

multiSeriesUniform : bool

定义即使显示多个序列，柱条是否与单个系列柱条的缩放比例相匹配。如果设置为 true，则 bar spacing 将仅正确应用于 X 轴。默认预设为 false。

primarySeries : Bar3DSeries

图形的主要序列。它用于确定在标签未明确设置到轴上时的行和列轴标签。

如果指定的序列尚未添加到图中，将其设置为主要序列也会隐式将其添加到图中。

如果主要序列本身从图中删除，则此属性将重置为默认值。

如果序列为空，则此属性将重置为默认值。默认为添加到图中的第一个序列或为零，如果没有序列添加到图中。

rowAxis : CategoryAxis3D

活动行轴。

如果没有指定轴，将创建一个没有标签的临时默认轴。如果显式地将另一个轴设置为相同的方向，则此临时轴将被销毁。

selectedSeries : Bar3DSeries

所选序列或 null。如果 selectionMode 设置了 SelectionMultiSeries 标志，则此属性包含拥有所选柱条的序列。

seriesList : list<Bar3DSeries> [默认]

图形的序列。默认情况下，此属性包含一个空列表。要设置序列，请使用 addSeries() 函数或将其定义为图形的子项。

valueAxis : ValueAxis3D

活动值轴。

如果没有指定轴，将创建一个没有标签且范围自动调整的临时默认轴。如果显式地将另一个轴设置为相同的方向，则此临时轴将被销毁。

方法文档

void addSeries(Bar3DSeries series)

将系列添加到图表中。图表可以包含多个系列，但只有一个坐标轴集，因此所有系列行和列必须匹配，以便可视化数据才有意义。如果图表有多个可见系列，则只有第一个添加的系列将在坐标轴上生成行或列标签（在这种情况下，标签未明确设置为坐标轴）。如果新添加的系列指定了选中的条形，则将突出显示，并清除任何现有选择。只有一个添加的系列可以有一个活动选择。

另请参阅AbstractGraph3D::hasSeries().

void insertSeries(int index, Bar3DSeries series)

将系列插入到系列列表中的索引位置index。如果系列series已经添加到列表中，则将其移动到新的索引位置。

注意：当将系列移动到一个新索引ări和它的旧索引之后的索引时，列表中新位置的计算好像系列仍在旧索引位置一样，因此最终索引实际上是index减一度。

另请参阅AbstractGraph3D::hasSeries().

void removeSeries(Bar3DSeries series)

从图表中删除系列。

另请参阅AbstractGraph3D::hasSeries().