Bars3D QML Type

3D条形图。更多...

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

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

属性

• 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 Data Visualization C++ Classes。

属性文档

barSeriesMargin : size [since 6.3]

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

该属性自 Qt 6.3 起引入。

barSpacing : size

X 和 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> [default]

图表的系列。默认情况下，此属性包含一个空列表。要设置系列，可以使用addSeries()函数，或者将其定义为图表的子元素。

valueAxis : ValueAxis3D

活动值轴。

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

方法文档

void addSeries(Bar3DSeries series)

将series 添加到图表中。一个图表可以包含多个系列，但只能有一组坐标轴，因此所有系列的行和列必须匹配，可视化数据才有意义。 如果图表中有多个可见系列，且未显式为坐标轴设置标签，则只有第一个添加的系列会在坐标轴上生成行或列标签。如果新添加的系列指定了选定条形，该条形将被高亮显示，且任何现有的选择都将被清除。仅有一个添加的系列可以具有活动选择。

另请参阅 AbstractGraph3D::hasSeries()。

void insertSeries(int index, Bar3DSeries series)

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

另请参阅 AbstractGraph3D::hasSeries()。

void removeSeries(Bar3DSeries series)

从图中移除series 。

另请参阅 AbstractGraph3D::hasSeries()。