Bars3D QML Type
三维条形图。更多
Import Statement: | import QtDataVisualization 1.9 |
Since: | QtDataVisualization 1.0 |
Inherits: |
属性
- 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 |
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 |
图表的主系列。在未明确设置坐标轴标签时,它用于确定行和列坐标轴标签。
如果指定的序列尚未添加到图形中,将其设置为主序列也会将其隐式添加到图形中。
如果从图形中删除了主系列,该属性将重置为默认值。
如果序列为空,该属性将重置为默认值。默认值为第一个添加的序列,如果没有序列添加到图表中,则默认值为 0。
rowAxis : CategoryAxis3D |
活动行轴。
如果没有给出坐标轴,则会创建一个没有标签的临时默认坐标轴。如果另一个轴被明确设置为相同方向,则该临时轴将被销毁。
selectedSeries : Bar3DSeries |
选定的系列或null
。如果selectionMode 已设置SelectionMultiSeries
标志,则该属性将保存选定条形图的系列。
seriesList : list<Bar3DSeries> |
图形的系列。默认情况下,此属性包含一个空列表。要设置序列,可使用addSeries() 函数或将其定义为图形的子序列。
valueAxis : ValueAxis3D |
活动值轴。
如果没有给出坐标轴,则会创建一个没有标签和自动调整范围的临时默认坐标轴。如果将另一个轴明确设置为相同方向,则会销毁该临时轴。
方法文档
void addSeries(Bar3DSeries series) |
将series 添加到图表中。一个图表可以包含多个序列,但只有一组坐标轴,因此所有序列的行和列必须匹配,这样可视化数据才有意义。如果图形有多个可见序列,在未明确设置坐标轴标签的情况下,只有第一个添加的序列才会在坐标轴上生成行或列标签。如果新添加的序列已指定了一个选定的柱形图,则该柱形图将突出显示,并且任何现有的选 择都将被清除。只有一个添加的序列可以有活动选区。
另请参阅 AbstractGraph3D::hasSeries() 。
void insertSeries(int index, Bar3DSeries series) |
将series 插入系列列表中的index 位置。如果series 已经添加到列表中,则会移动到新的index 中。
注意: 当将系列移至其旧索引之后的新index 时,列表中的新位置是按照系列仍在其旧索引中的情况计算的,因此最终索引实际上是index 减一。
另请参见 AbstractGraph3D::hasSeries()。
void removeSeries(Bar3DSeries series) |
从图表中删除series 。
另请参阅 AbstractGraph3D::hasSeries().
© 2025 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.