QHXYModelMapper Class
QHXYModelMapper 类是一个水平模型映射器，适用于线性、样条和散点序列。更多
| Header: | #include <QHXYModelMapper> |
| In QML: | HXYModelMapper |
| Inherits: | QXYModelMapper |
属性
|
公共功能
| QHXYModelMapper(QObject *parent = nullptr) | |
| int | columnCount() const |
| int | firstColumn() const |
| QAbstractItemModel * | model() const |
| QXYSeries * | series() const |
| void | setColumnCount(int columnCount) |
| void | setFirstColumn(int firstColumn) |
| void | setModel(QAbstractItemModel *model) |
| void | setSeries(QXYSeries *series) |
| void | setXRow(int xRow) |
| void | setYRow(int yRow) |
| int | xRow() const |
| int | yRow() const |
信号
| void | columnCountChanged() |
| void | firstColumnChanged() |
| void | modelReplaced() |
| void | seriesReplaced() |
| void | xRowChanged() |
| void | yRowChanged() |
详细说明
模型映射器可将源自QAbstractItemModel 类的数据模型用作图表的数据源。水平模型映射器用于在直线、样条线或散点图系列与数据模型之间建立连接，数据模型的X和Y行表示坐标，XYSeries 的数据点表示列。自然可以选择TableModel作为模型。
模型和序列属性都可用于操作数据。模型映射器可使系列和数据模型保持同步。
另请参阅 QVXYModelMapper,QXYSeries, 以及带 Widgets 图库的图表。
属性文档
columnCount : int
该属性用于保存被映射为序列数据的模型列数。
最小默认值为-1（该数值受模型列数的限制）。
访问功能：
| int | columnCount() const |
| void | setColumnCount(int columnCount) |
Notifier 信号：
| void | columnCountChanged() |
firstColumn : int
该属性用于保存模型中包含序列第一点数据的列。
最小默认值为 0。
访问功能：
| int | firstColumn() const |
| void | setFirstColumn(int firstColumn) |
通知信号：
| void | firstColumnChanged() |
model : QAbstractItemModel*
该属性包含映射器使用的模型。
访问功能：
| QAbstractItemModel * | model() const |
| void | setModel(QAbstractItemModel *model) |
Notifier 信号：
| void | modelReplaced() |
series : QXYSeries*
该属性包含映射器使用的系列。
该系列中的所有数据在设置给映射器时都会被丢弃。当指定一个新系列时，旧系列将被断开（但保留其数据）。
访问功能：
| QXYSeries * | series() const |
| void | setSeries(QXYSeries *series) |
通知信号：
| void | seriesReplaced() |
xRow : int
该属性用于保存模型中包含数据点 x 坐标的行。
默认值为-1（无效映射）。
访问功能：
| int | xRow() const |
| void | setXRow(int xRow) |
通知信号：
| void | xRowChanged() |
yRow : int
该属性用于保存模型中包含数据点 Y 坐标的行。
默认值为-1（无效映射）。
访问功能：
| int | yRow() const |
| void | setYRow(int yRow) |
Notifier 信号：
| void | yRowChanged() |
成员函数 文档
[explicit] QHXYModelMapper::QHXYModelMapper(QObject *parent = nullptr)
构造一个parent 的子映射器对象。
[signal] void QHXYModelMapper::columnCountChanged()
列数发生变化时会发出该信号。
注： 属性columnCount 的通知信号。
[signal] void QHXYModelMapper::firstColumnChanged()
该信号在第一列发生变化时发出。
注： 属性firstColumn 的通知信号。
[signal] void QHXYModelMapper::modelReplaced()
当映射器所连接的模型发生变化时会发出该信号。
注： 用于属性model 的 Notifier 信号。
[signal] void QHXYModelMapper::seriesReplaced()
当映射器连接的系列发生变化时，会发出该信号。
注： 用于属性series 的通知信号。
[signal] void QHXYModelMapper::xRowChanged()
当包含数据点 x 坐标的行发生变化时，会发出该信号。
注： 属性xRow 的通知信号。
[signal] void QHXYModelMapper::yRowChanged()
当包含数据点 y 坐标的行发生变化时，会发出该信号。
注： 属性yRow 的通知信号。
© 2025 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.
