QAbstractBarSeries 类

QAbstractBarSeries 类是所有条形图类的抽象基类。更多...

头文件 #include <QAbstractBarSeries>
CMakefind_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmakeQT += graphs
由以下实例化 AbstractBarSeries
继承自 QAbstractSeries
继承以下类

QBarSeries

状态技术预览

公共类型

枚举LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd }

属性

公共函数

virtual~QAbstractBarSeries()
boolappend(QBarSet *set)
boolappend(const QList<QBarSet *> &sets)
QList<QBarSet *>barSets() const
qrealbarWidth() const
voidclear()
intcount() const
boolinsert(int index, QBarSet *set)
boolisLabelsVisible() const
qreallabelsAngle() const
QStringlabelsFormat() const
QAbstractBarSeries::LabelsPositionlabelsPosition() const
intlabelsPrecision() const
boolremove(QBarSet *set)
voidsetBarWidth(qreal width)
voidsetLabelsAngle(qreal angle)
voidsetLabelsFormat(const QString &format)
voidsetLabelsPosition(QAbstractBarSeries::LabelsPosition position)
voidsetLabelsPrecision(int precision)
voidsetLabelsVisible(bool visible = true)
booltake(QBarSet *set)

信号

voidbarWidthChanged()
voidbarsetsAdded(const QListsets)
voidbarsetsRemoved(const QListsets)
voidclicked(int index, QBarSet *barset)
voidcountChanged()
voiddoubleClicked(int index, QBarSet *barset)
voidhovered(bool status, int index, QBarSet *barset)
voidlabelsAngleChanged(qreal angle)
voidlabelsFormatChanged(const QString &format)
voidlabelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
voidlabelsPrecisionChanged(int precision)
voidlabelsVisibleChanged()
voidpressed(int index, QBarSet *barset)
voidreleased(int index, QBarSet *barset)

详细描述

在柱状图中,柱形定义为包含每个类别一个数据值的柱形集。柱形的位置由类别指定,其高度由数据值指定。包含多个柱形集的柱形系列将属于同一类别的柱形组合在一起。柱形显示的方式取决于创建柱状图所选择的此类的子类。

另请参阅QBarSetQBarSeries.

成员类型文档

enum QAbstractBarSeries::LabelsPosition

此枚举值描述了数据值标签的位置

常量描述
QAbstractBarSeries::LabelsCenter0标签位于柱形的中心。
QAbstractBarSeries::LabelsInsideEnd1标签位于柱形内部的上端。
QAbstractBarSeries::LabelsInsideBase2标签位于柱形内部的下端。
QAbstractBarSeries::LabelsOutsideEnd3标签位于柱形外部上端。

属性文档

barWidth : qreal

该属性持有系列柱形的宽度。

宽度的单位是x轴的单位。柱形的最小宽度为零,负值被视为零。将宽度设置为零意味着无论x轴的比例如何,柱形在屏幕上的宽度都是一个像素。大于零的柱形使用x轴比例进行缩放。

默认情况下,柱形宽度为0.5(柱形将占用50%的可用宽度)。有效值的范围从0.0(0%)到1.0(100%)。

注意:当与QBarSeries一起使用时,此值指定一组柱形的宽度,而不是单个柱形的宽度。

访问函数

qrealbarWidth() const
voidsetBarWidth(qreal width)

通知信号

另请参阅QBarSeries.

[只读] count : const int

该属性持有柱形系列中柱形集的数量。

访问函数

intcount() const

通知信号

voidcountChanged()

labelsAngle : qreal

此属性存储条形图值标签的角度(以度为单位)。

访问函数

qreallabelsAngle() const
voidsetLabelsAngle(qreal angle)

通知信号

voidlabelsAngleChanged(qreal angle)

labelsFormat : QString

此属性存储用于显示条形图中标签的格式。

QAbstractBarSeries 支持以下格式标签

@value条形图的值

例如,以下格式标签的使用将产生显示值和单位(u)的标签

series->setLabelsFormat("@value u");

默认情况下,标签显示条形的值。对于百分比条形图系列,将在值后添加 %。标签显示在绘图区域内,如果条形图靠得很近,标签可能重叠。

访问函数

QStringlabelsFormat() const
voidsetLabelsFormat(const QString &format)

通知信号

voidlabelsFormatChanged(const QString &format)

另请参阅 labelsVisiblelabelsPositionlabelsPrecision

labelsPosition : LabelsPosition

此属性存储值标签的位置。

访问函数

QAbstractBarSeries::LabelsPositionlabelsPosition() const
voidsetLabelsPosition(QAbstractBarSeries::LabelsPosition position)

通知信号

voidlabelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

另请参阅 labelsVisiblelabelsFormat

labelsPrecision : int

此属性存储在值标签中显示的最大有效数字数量。

默认值为 6。

访问函数

intlabelsPrecision() const
voidsetLabelsPrecision(int precision)

通知信号

voidlabelsPrecisionChanged(int precision)

labelsVisible : bool

此属性保存条形系列中标签的可见性。

访问函数

boolisLabelsVisible() const
voidsetLabelsVisible(bool visible = true)

通知信号

成员函数文档

[虚函数异常安全] QAbstractBarSeries::~QAbstractBarSeries()

删除抽象条形系列及其拥有的条形集合。

bool QAbstractBarSeries::append(QBarSet *set)

set 指定的条形集添加到条形系列中,并获取对该集的所有权。如果集合为空或已属于系列,则不会添加。如果添加成功,则返回 true

bool QAbstractBarSeries::append(const QList<QBarSet *> &sets)

sets指定的条形集合列表添加到条形序列中,并取得集合的拥有权。如果所有集合都添加成功,则返回true。如果任一集合为空或之前已添加到序列中,则不添加任何内容,此函数返回false。如果任一集合在列表中重复出现多次,则不添加任何内容,此函数返回false

QList<QBarSet *> QAbstractBarSeries::barSets() const

返回条形序列中的条形集合列表。保持条形集合的拥有权。

qreal QAbstractBarSeries::barWidth() const

返回序列中条形的宽度。

注意:属性barWidth的获取器函数。

另请参阅:setBarWidth

[信号] void QAbstractBarSeries::barWidthChanged()

当条形宽度改变时,会发出此信号。

注意:属性<販href="qabstractbarseries.html#barWidth" translate="no">barWidth的通知信号。

[信号] void QAbstractBarSeries::barsetsAdded(const QList<QBarSet *> &sets)

当根据sets指定的条形集合添加到序列时,会发出此信号。

另请参阅:append()和insert()。

[信号] void QAbstractBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)

当根据sets指定的条形集合从序列中删除时,会发出此信号。

另请参阅:remove

void QAbstractBarSeries::clear()

从序列中删除所有条形集合,并永久删除它们。

[信号] void QAbstractBarSeries::clicked(int index, QBarSet *barset)

当用户点击barset指定的条形集合中由index指定的条形时,会发出此信号。

int QAbstractBarSeries::count() const

返回条形序列中的条形集合数量。

注意:属性count的获取器函数。

[信号] void QAbstractBarSeries::countChanged()

当条形集合数量改变时,例如通过append()或remove(),会发出此信号。

注意:属性<款href="qabstractbarseries.html#count" translate="no">count的通知信号。

[信号] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)

当用户双击由 index 指定的 barset 中指定的条时,会发出此信号。

[信号] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)

当鼠标悬停在由 index 指定的 barset 中的条上时,会发出此信号。当鼠标悬停在条上时,status 变为 true,当鼠标再次移开时,它变为 false

bool QAbstractBarSeries::insert(int index, QBarSet *set)

将指定的 set 条插入到由 index 指定位置的系列中,并获取该集的所有权。如果集为空或已属于系列,则不会附加。如果插入成功,则返回 true

bool QAbstractBarSeries::isLabelsVisible() const

返回标签的可见性。

注意:属性 labelsVisible 的获取函数。

[信号] void QAbstractBarSeries::labelsAngleChanged(qreal angle)

当值标签的角度 angle 发生变化时,会发出此信号。

注意:属性 labelsAngle 的通知信号。

[信号] void QAbstractBarSeries::labelsFormatChanged(const QString &format)

当数据值标签的 format 发生变化时,会发出此信号。

注意:属性 labelsFormat 的通知信号。

[信号] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

当值标签的位置 position 发生变化时,会发出此信号。

注意:属性 labelsPosition 的通知信号。

[信号] void QAbstractBarSeries::labelsPrecisionChanged(int precision)

当值标签的 precision 发生变化时,会发出此信号。

注意:属性 labelsPrecision 的通知信号。

[信号] void QAbstractBarSeries::labelsVisibleChanged()

当标签的可见性发生变化时,会发出此信号。

注意:属性 labelsVisible 的通知信号。

另请参阅 isLabelsVisible() 和 setLabelsVisible().

[信号] void QAbstractBarSeries::pressed(int index, QBarSet *barset)

当用户点击指定的 index 栏组中指定 barset 的栏时并发送鼠标按钮并按住时,将发出此信号。

[信号] void QAbstractBarSeries::released(int index, QBarSet *barset)

当用户释放指定 index 栏组中指定 barset 的栏上的鼠标按钮时,将发出此信号。

bool QAbstractBarSeries::remove(QBarSet *set)

从系列中删除指定的 set 栏组,并在删除成功时永久删除它。如果删除成功,则返回 true

void QAbstractBarSeries::setBarWidth(qreal width)

将系列中的栏宽设置为 width

注意: 属性 barWidth 的设置器函数。

另请参阅 barWidth().

void QAbstractBarSeries::setLabelsVisible(bool visible = true)

将条形系列的标签可见性设置为 visible

注意: 属性 labelsVisible 的设置器函数。

另请参阅 isLabelsVisible().

bool QAbstractBarSeries::take(QBarSet *set)

从系列中取出一个 set。不会删除栏组对象。

注意: 系列仍然是栏组的父对象。您必须设置父对象以完全拥有权限。

如果取操作成功,则返回 true

© 2024 Qt 公司有限公司。本文档中包含的文档贡献享有其各自所有者的版权。此处提供的文档根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款获得许可。Qt 及其 respective 标志是芬兰的 Qt 公司及/或其他国家/地区的商标。所有其他商标均为各自所有者的财产。