QAbstractBarSeries 类
QAbstractBarSeries 类是所有条形图类的抽象基类。更多...
头文件 | #include <QAbstractBarSeries> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
qmake | QT += graphs |
由以下实例化 | AbstractBarSeries |
继承自 | QAbstractSeries |
继承以下类 | |
状态 | 技术预览 |
- 包括继承成员的所有成员列表
- QAbstractBarSeries 是 Qt 图形 2D C++ 类 的一部分。
公共类型
枚举 | LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd } |
属性
|
|
公共函数
virtual | ~QAbstractBarSeries() |
bool | append(QBarSet *set) |
bool | append(const QList<QBarSet *> &sets) |
QList<QBarSet *> | barSets() const |
qreal | barWidth() const |
void | clear() |
int | count() const |
bool | insert(int index, QBarSet *set) |
bool | isLabelsVisible() const |
qreal | labelsAngle() const |
QString | labelsFormat() const |
QAbstractBarSeries::LabelsPosition | labelsPosition() const |
int | labelsPrecision() const |
bool | remove(QBarSet *set) |
void | setBarWidth(qreal width) |
void | setLabelsAngle(qreal angle) |
void | setLabelsFormat(const QString &format) |
void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
void | setLabelsPrecision(int precision) |
void | setLabelsVisible(bool visible = true) |
bool | take(QBarSet *set) |
信号
void | barWidthChanged() |
void | barsetsAdded(const QList |
void | barsetsRemoved(const QList |
void | clicked(int index, QBarSet *barset) |
void | countChanged() |
void | doubleClicked(int index, QBarSet *barset) |
void | hovered(bool status, int index, QBarSet *barset) |
void | labelsAngleChanged(qreal angle) |
void | labelsFormatChanged(const QString &format) |
void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
void | labelsPrecisionChanged(int precision) |
void | labelsVisibleChanged() |
void | pressed(int index, QBarSet *barset) |
void | released(int index, QBarSet *barset) |
详细描述
在柱状图中,柱形定义为包含每个类别一个数据值的柱形集。柱形的位置由类别指定,其高度由数据值指定。包含多个柱形集的柱形系列将属于同一类别的柱形组合在一起。柱形显示的方式取决于创建柱状图所选择的此类的子类。
另请参阅QBarSet 和 QBarSeries.
成员类型文档
enum QAbstractBarSeries::LabelsPosition
此枚举值描述了数据值标签的位置
常量 | 值 | 描述 |
---|---|---|
QAbstractBarSeries::LabelsCenter | 0 | 标签位于柱形的中心。 |
QAbstractBarSeries::LabelsInsideEnd | 1 | 标签位于柱形内部的上端。 |
QAbstractBarSeries::LabelsInsideBase | 2 | 标签位于柱形内部的下端。 |
QAbstractBarSeries::LabelsOutsideEnd | 3 | 标签位于柱形外部上端。 |
属性文档
barWidth : qreal
该属性持有系列柱形的宽度。
宽度的单位是x轴的单位。柱形的最小宽度为零,负值被视为零。将宽度设置为零意味着无论x轴的比例如何,柱形在屏幕上的宽度都是一个像素。大于零的柱形使用x轴比例进行缩放。
默认情况下,柱形宽度为0.5(柱形将占用50%的可用宽度)。有效值的范围从0.0(0%)到1.0(100%)。
注意:当与QBarSeries一起使用时,此值指定一组柱形的宽度,而不是单个柱形的宽度。
访问函数
qreal | barWidth() const |
void | setBarWidth(qreal width) |
通知信号
void | barWidthChanged() |
另请参阅QBarSeries.
[只读]
count : const int
该属性持有柱形系列中柱形集的数量。
访问函数
int | count() const |
通知信号
void | countChanged() |
labelsAngle : qreal
此属性存储条形图值标签的角度(以度为单位)。
访问函数
qreal | labelsAngle() const |
void | setLabelsAngle(qreal angle) |
通知信号
void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
此属性存储用于显示条形图中标签的格式。
QAbstractBarSeries 支持以下格式标签
@value | 条形图的值 |
例如,以下格式标签的使用将产生显示值和单位(u)的标签
series->setLabelsFormat("@value u");
默认情况下,标签显示条形的值。对于百分比条形图系列,将在值后添加 %。标签显示在绘图区域内,如果条形图靠得很近,标签可能重叠。
访问函数
QString | labelsFormat() const |
void | setLabelsFormat(const QString &format) |
通知信号
void | labelsFormatChanged(const QString &format) |
另请参阅 labelsVisible、labelsPosition 和 labelsPrecision。
labelsPosition : LabelsPosition
此属性存储值标签的位置。
访问函数
QAbstractBarSeries::LabelsPosition | labelsPosition() const |
void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
通知信号
void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
另请参阅 labelsVisible 和 labelsFormat。
labelsPrecision : int
此属性存储在值标签中显示的最大有效数字数量。
默认值为 6。
访问函数
int | labelsPrecision() const |
void | setLabelsPrecision(int precision) |
通知信号
void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
此属性保存条形系列中标签的可见性。
访问函数
bool | isLabelsVisible() const |
void | setLabelsVisible(bool visible = true) |
通知信号
void | labelsVisibleChanged() |
成员函数文档
[虚函数异常安全]
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指定的条形集合添加到序列时,会发出此信号。
[信号]
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 公司及/或其他国家/地区的商标。所有其他商标均为各自所有者的财产。