QHBarModelMapper Class
QHBarModelMapper 类是一个用于条形图系列的水平模型映射器。更多内容...
| Header: | #include <QHBarModelMapper> |
| In QML: | HBarModelMapper |
| Inherits: | QObject |
| Status: | Deprecated |
该类已弃用。我们强烈建议不要在新的代码中使用它。
属性
|
|
公共函数
| QHBarModelMapper(QObject *parent = nullptr) | |
| int | columnCount() const |
| int | firstBarSetRow() const |
| int | firstColumn() const |
| int | lastBarSetRow() const |
| QAbstractItemModel * | model() const |
| QAbstractBarSeries * | series() const |
| void | setColumnCount(int columnCount) |
| void | setFirstBarSetRow(int firstBarSetRow) |
| void | setFirstColumn(int firstColumn) |
| void | setLastBarSetRow(int lastBarSetRow) |
| void | setModel(QAbstractItemModel *model) |
| void | setSeries(QAbstractBarSeries *series) |
信号
| void | columnCountChanged() |
| void | firstBarSetRowChanged() |
| void | firstColumnChanged() |
| void | lastBarSetRowChanged() |
| void | modelReplaced() |
| void | seriesReplaced() |
详细说明
模型映射器支持将源自QAbstractItemModel 类的数据模型用作图表的数据源。水平模型映射器用于在数据模型与QAbstractBarSeries 之间建立连接，从而使数据模型中的每一行定义一组条形，每一列映射到条形序列中的一个类别。
既可以使用模型属性，也可以使用条形序列属性来操作数据。模型映射器会保持条形序列与数据模型的同步。
模型映射器可确保条形系列中的所有条形集大小一致。因此，向某个条形集添加或从中移除一个值，会导致条形系列中的所有条形集发生相同的变更。
另请参阅 QVBarModelMapper 。
属性文档
columnCount : int
该属性存储了模型中映射为条形图系列数据列的数量。
其最小值和默认值为 -1（数值上限为模型中的列数）。
访问函数：
| int | columnCount() const |
| void | setColumnCount(int columnCount) |
通知信号：
| void | columnCountChanged() |
firstBarSetRow : int
该属性存储用作第一个条形图集数据源的模型行。
默认值为 -1（映射无效）。
访问函数：
| int | firstBarSetRow() const |
| void | setFirstBarSetRow(int firstBarSetRow) |
通知器信号：
| void | firstBarSetRowChanged() |
firstColumn : int
该属性存储模型中包含条形序列中各条形集的首个值的列。
其最小值和默认值均为 0。
访问函数：
| int | firstColumn() const |
| void | setFirstColumn(int firstColumn) |
通知信号：
| void | firstColumnChanged() |
lastBarSetRow : int
该属性存储了用作最后一个柱状图集数据源的模型行。
默认值为 -1（映射无效）。
访问函数：
| int | lastBarSetRow() const |
| void | setLastBarSetRow(int lastBarSetRow) |
通知信号：
| void | lastBarSetRowChanged() |
model : QAbstractItemModel*
定义映射器所使用的模型。
访问函数：
| QAbstractItemModel * | model() const |
| void | setModel(QAbstractItemModel *model) |
通知器信号：
| void | modelReplaced() |
series : QAbstractBarSeries*
该属性存储映射器所使用的条形图系列。
当该系列被设置为映射器时，其中的所有数据都会被丢弃。当指定新的系列时，旧系列将被断开连接（但其数据仍会被保留）。
访问函数：
| QAbstractBarSeries * | series() const |
| void | setSeries(QAbstractBarSeries *series) |
通知器信号：
| void | seriesReplaced() |
成员函数文档
[explicit] QHBarModelMapper::QHBarModelMapper(QObject *parent = nullptr)
构建一个作为parent 子节点的映射器对象。
[signal] void QHBarModelMapper::columnCountChanged()
当列数发生变化时，会触发此信号。
注意： 这是属性columnCount的通知器 信号。
[signal] void QHBarModelMapper::firstBarSetRowChanged()
当第一个柱状图行发生变化时，会发出此信号。
注意： 这是属性firstBarSetRow的通知器 信号。
[signal] void QHBarModelMapper::firstColumnChanged()
当第一列发生变化时，会触发此信号。
注意： 这是属性firstColumn的通知器 信号。
[signal] void QHBarModelMapper::lastBarSetRowChanged()
当最后一个柱状图行发生变化时，会发出此信号。
注意： 这是属性lastBarSetRow的通知 信号。
[signal] void QHBarModelMapper::modelReplaced()
当映射器所连接的模型发生变化时，会触发此信号。
注意： 这是属性model的通知器 信号。
[signal] void QHBarModelMapper::seriesReplaced()
当映射器所连接的系列发生变化时，会发出此信号。
注意： 这是属性series的通知器 信号。
© 2026 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.
