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 为null，则会创建一个没有标签的临时默认坐标轴。如果显式地将另一个坐标轴设置为相同的方位，则该临时坐标轴将被销毁。

访问函数：

通知器信号：

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

floorLevel : float

该属性用于指定条形图在Y轴数据坐标系中的下限。

实际底线高度将受Y轴最小值和最大值的限制。默认值为零。

访问函数：

通知信号：

multiSeriesUniform : bool

无论显示的是多个系列，该属性都会决定条形是否根据单个系列的条形比例进行缩放。

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

访问函数：

通知信号：

primarySeries : QBar3DSeries*

该属性存储图表的主序列。

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

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

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

如果 `series ` 为空，则该属性将重置为默认值。默认值为第一个添加的系列；如果图表中未添加任何系列，则默认值为零。

访问函数：

通知信号：

rowAxis : QCategory3DAxis*

该属性存储与活动行关联的坐标轴。

将活动行的坐标轴设置为axis 。会隐式调用addAxis()，将该坐标轴的所有权转移至此图表。

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

访问函数：

通知器信号：

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

[read-only] selectedSeries : QBar3DSeries*

该属性保存所选系列或一个空值。

如果 selectionMode 设置了SelectionMultiSeries 标志，则该属性将存储包含所选柱状图的系列。

访问函数：

通知器信号：

valueAxis : QValue3DAxis*

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

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

访问函数：

通知器信号：

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

connect(item, &Q3DBarsWidgetItem::sliceImageChanged, this, [](const QImage &image) {
    // ~~~
});

item->renderSliceToImage(sliceType, index);