Q3DBarsWidgetItem Class

QQuickWidget quickWidget;
Q3DBarsWidgetItem bars;
bars.setWidget(&quickWidget);
bars.widget()->setMinimumSize(QSize(256, 256));

bars.rowAxis()->setRange(0, 4);
bars.columnAxis()->setRange(0, 4);

QBar3DSeries series;
QBarDataRow data;
data << QBarDataItem(1.0f) << QBarDataItem(3.0f) << QBarDataItem(7.5f) << QBarDataItem(5.0f)
     << QBarDataItem(2.2f);
series.dataProxy()->addRow(data);
bars.addSeries(&series);

bars.widget()->show();

#include <QtGraphs>
#include <QtGraphsWidgets/q3dbarswidgetitem.h>
#include <QtWidgets/qapplication.h>
int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    QQuickWidget quickWidget;
    Q3DBarsWidgetItem bars;
    bars.setWidget(&quickWidget);
    bars.widget()->setMinimumSize(QSize(256, 256));
    bars.rowAxis()->setRange(0, 4);
    bars.columnAxis()->setRange(0, 4);
    QBar3DSeries series;
    QBarDataRow data;
    data << QBarDataItem(1.0f) << QBarDataItem(3.0f) << QBarDataItem(7.5f) << QBarDataItem(5.0f)
         << QBarDataItem(2.2f);
    series.dataProxy()->addRow(data);
    bars.addSeries(&series);
    bars.widget()->show();

    return app.exec();
}

属性文档

barSeriesMargin : QSizeF

系列列之间在 X 和 Z 维度上的边距。合理值范围为 [0,1)。

默认设置为(0.0, 0.0) 。使用该属性可以并排显示不同系列的条形图，但列与列之间要留出空间。

访问功能：

通知信号：

另请参阅 barSpacing 。

barSpacing : QSizeF

X 和 Z 尺寸的条形图间距。

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

访问功能：

通知信号：

另请参阅 barSpacingRelative,multiSeriesUniform, 和barSeriesMargin 。

barSpacingRelative : bool

该属性表示间距是绝对的还是相对于条形码厚度的。

如果是true ，则0.0 的值表示条形图是并排放置的，1.0 表示条形图之间留有与一个条形图厚度等宽的空间，依此类推。预设为true 。

访问功能：

通知信号：

barThickness : float

该属性表示 X 和 Z 尺寸之间的条形厚度比。

1.0 表示条形图的宽度与深度相同，而0.5 则表示条形图的深度是宽度的两倍。默认设置为1.0 。

访问功能：

通知信号：

columnAxis : QCategory3DAxis*

该属性用于保存与活动列相连的坐标轴。

将活动列的坐标轴设置为axis 。隐式调用addAxis() 将坐标轴的所有权转移到此图形。

如果axis 为空，则会创建一个没有标签的临时默认坐标轴。如果另一个轴被显式设置为相同方向，则该临时轴将被销毁。

访问功能：

Notifier 信号：

另请参见 addAxis() 和releaseAxis()。

floorLevel : float

该属性以 Y 轴数据坐标表示条形图的层高。

实际底层水平将受 Y 轴最小值和最大值的限制。默认值为零。

访问功能：

通知信号：

multiSeriesUniform : bool

即使显示多个系列，此属性也可确定是否要将条形图的缩放比例设置为单个系列条形图的缩放比例。

如果设置为true ，bar spacing 将仅正确应用于 X 轴。默认设置为false 。

访问功能：

通知信号：

primarySeries : QBar3DSeries*

该属性用于保存图表的主要序列。

将series 设置为图表的主数列。当坐标轴未显式设置标签时，主系列将决定行坐标轴和列坐标轴的标签。

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

如果从图表中删除了主系列，该属性将重置为默认值。

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

访问功能：

通知信号：

rowAxis : QCategory3DAxis*

该属性用于保存与活动行相连的坐标轴。

将活动行的坐标轴设置为axis 。隐式调用addAxis() 将坐标轴的所有权转移到此图形。

如果axis 为空，则会创建一个没有标签的临时默认坐标轴。如果另一个坐标轴被明确设置为相同方向，则该临时坐标轴将被销毁。

访问功能：

Notifier 信号：

另请参见 addAxis() 和releaseAxis()。

[read-only] selectedSeries : QBar3DSeries* const

该属性包含所选系列或空值。

如果 selectionMode 设置了SelectionMultiSeries 标志，此属性将保存所选条形图的系列。

访问功能：

通知信号：

valueAxis : QValue3DAxis*

将活动值轴（Y 轴）设置为axis 。隐式调用addAxis() 将axis 的所有权转移到该图表。

如果axis 为空，则会创建一个没有标签和自动调整范围的临时默认坐标轴。如果将另一个轴明确设置为相同方向，则会销毁该临时轴。

访问功能：

通知信号：

另请参见 addAxis() 和releaseAxis()。