QVPieModelMapper Class
QVPieModelMapper 是一个用于饼图系列的垂直模型映射器。更多内容...
| Header: | #include <QVPieModelMapper> |
| In QML: | VPieModelMapper |
| Inherits: | QPieModelMapper |
| Status: | Deprecated |
该类已弃用。我们强烈建议不要在新代码中使用它。
属性
|
|
公共函数
| QVPieModelMapper(QObject *parent = nullptr) | |
| int | firstRow() const |
| int | labelsColumn() const |
| QAbstractItemModel * | model() const |
| int | rowCount() const |
| QPieSeries * | series() const |
| void | setFirstRow(int firstRow) |
| void | setLabelsColumn(int labelsColumn) |
| void | setModel(QAbstractItemModel *model) |
| void | setRowCount(int rowCount) |
| void | setSeries(QPieSeries *series) |
| void | setValuesColumn(int valuesColumn) |
| int | valuesColumn() const |
信号
| void | firstRowChanged() |
| void | labelsColumnChanged() |
| void | modelReplaced() |
| void | rowCountChanged() |
| void | seriesReplaced() |
| void | valuesColumnChanged() |
详细说明
模型映射器允许将源自QAbstractItemModel 类的数据模型用作图表的数据源。垂直模型映射器用于在数据模型与QPieSeries 之间建立连接，使得数据模型中的每一行定义一个扇区，每一列则映射到该扇区的标签或数值。
既可以使用模型属性，也可以使用扇形图系列属性来操作数据。模型映射器会保持扇形图系列与数据模型之间的同步。
属性文档
firstRow : int
该属性保存了包含第一个切片值的模型行。
其最小值和默认值均为 0。
访问函数：
| int | firstRow() const |
| void | setFirstRow(int firstRow) |
通知器信号：
| void | firstRowChanged() |
labelsColumn : int
该属性存储了与饼图扇区标签保持同步的模型列。
默认值为 -1（映射无效）。
访问函数：
| int | labelsColumn() const |
| void | setLabelsColumn(int labelsColumn) |
通知信号：
| void | labelsColumnChanged() |
model : QAbstractItemModel*
该属性保存了映射器所使用的模型。
访问函数：
| QAbstractItemModel * | model() const |
| void | setModel(QAbstractItemModel *model) |
通知器信号：
| void | modelReplaced() |
rowCount : int
该属性用于指定模型中映射为饼图系列数据行的数量。
其最小值和默认值均为 -1（数值上限受模型中行数的限制）。
访问函数：
| int | rowCount() const |
| void | setRowCount(int rowCount) |
通知信号：
| void | rowCountChanged() |
series : QPieSeries*
该属性存储映射器所使用的饼图系列。
当该系列被设置为映射器时，其中的所有数据都会被丢弃。当指定新的系列时，旧系列将被断开连接（但其数据仍会被保留）。
访问函数：
| QPieSeries * | series() const |
| void | setSeries(QPieSeries *series) |
通知器信号：
| void | seriesReplaced() |
valuesColumn : int
该属性保存与饼图扇区值保持同步的模型列。
默认值为 -1（映射无效）。
访问函数：
| int | valuesColumn() const |
| void | setValuesColumn(int valuesColumn) |
通知器信号：
| void | valuesColumnChanged() |
成员函数文档
[explicit] QVPieModelMapper::QVPieModelMapper(QObject *parent = nullptr)
构建一个作为parent 子节点的映射器对象。
[signal] void QVPieModelMapper::firstRowChanged()
当第一行发生变化时，会触发此信号。
注意： 这是属性firstRow的通知器 信号。
int QVPieModelMapper::labelsColumn() const
返回模型中与饼图扇区标签保持同步的列。
注意： 这是 labelsColumn 属性的获取器 函数。
另请参阅 setLabelsColumn()。
[signal] void QVPieModelMapper::labelsColumnChanged()
当“标签”列发生变化时，会触发此信号。
注意： 这是属性labelsColumn的通知器 信号。
[signal] void QVPieModelMapper::modelReplaced()
当映射器所连接的模型发生变化时，会触发此信号。
注意： 这是属性model的通知器 信号。
[signal] void QVPieModelMapper::rowCountChanged()
当行数发生变化时，会发出此信号。
注意： 这是属性rowCount的通知器 信号。
[signal] void QVPieModelMapper::seriesReplaced()
当映射器所连接的系列发生变化时，会发出此信号。
注意： 这是属性series的通知器 信号。
void QVPieModelMapper::setLabelsColumn(int labelsColumn)
将与饼图扇区标签保持同步的模型列设置为labelsColumn 。
注意： 这是属性 `labelsColumn`的设置 函数。
另请参阅 labelsColumn()。
void QVPieModelMapper::setValuesColumn(int valuesColumn)
将与饼图扇区值保持同步的模型列设置为valuesColumn 。
注意： 这是属性valuesColumn 的设置 函数。
另请参阅 valuesColumn()。
int QVPieModelMapper::valuesColumn() const
返回模型中与饼图扇区值保持同步的列。
注意： 这是属性 valuesColumn 的获取 函数。
另请参阅 setValuesColumn()。
[signal] void QVPieModelMapper::valuesColumnChanged()
当“值”列发生变化时，会发出此信号。
注意： 这是属性valuesColumn的通知器 信号。
© 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.
