HBarModelMapper QML Type
バーシリーズ用の水平モデルマッパー。詳細...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QHBarModelMapper |
プロパティ
- columnCount : int
- firstBarSetRow : int
- firstColumn : int
- lastBarSetRow : int
- model : SomeModel
- series : AbstractBarSeries
詳細説明
HBarModelMapper 型は、QAbstractItemModel クラスから派生したデータモデルをチャートのデータソースとして使用できるようにします。水平モデルマッパーはデータモデルとAbstractBarSeries の間の接続を作成するために使用され、データモデルの各行が棒グラフを定義し、各列が棒グラフシリーズのカテゴリにマッピングされます。データモデルを実装し、QMLに公開する必要があります。
モデルプロパティとバーシリーズプロパティの両方を使ってデータを操作することができます。モデルマッパーはバーシリーズとデータモデルの同期を保ちます。
モデルマッパーは、棒グラフシリーズ内のすべての棒グラフセットのサイズが等しいことを保証します。したがって、あるバーセットに値を追加したり削除したりすると、バーシリーズ内のすべてのバーセットに同じ変更が行われます。
以下の QML コード・スニペットは、3 つのバーセットからなるバーシリーズを作成します(モデルには少なくとも 4 つの行があると仮定します)。各バーセットには、列 1 から始まるデータが含まれます。棒グラフセットの名前は、行のヘッダーによって定義されます。
BarSeries { HBarModelMapper { model: myCustomModel // QAbstractItemModel derived implementation firstBarSetRow: 1 lastBarSetRow: 3 firstColumn: 1 } }
VBarModelMapperも参照してください 。
プロパティのドキュメント
columnCount : int
棒系列のデータとしてマップされるモデルの列数。デフォルト値は-1(モデルの列数に制限される)。
firstBarSetRow : int
最初のバー・セットのデータ・ソースとしてモデルのどの行を使用するかを定義します。デフォルト値は -1(無効なマッピング)です。
firstColumn : int
バー・シリーズのバー・セットの最初の値を含むモデルの列。デフォルト値は 0。
lastBarSetRow : int
最後のバー・セットのデータ・ソースとして使用されるモデルの行。デフォルト値は -1(無効なマッピング)。
model : SomeModel
マッパーが使用するデータモデル。モデルを実装し、QMLに公開する必要があります。
注意: モデルは行や列の追加や削除、セル内のデータの変更をサポートする必要があります。
series : AbstractBarSeries
マッパーが使用するバーシリーズ。このシリーズがマッパーに設定されると、シリーズ内のデータはすべて破棄される。新しい系列が指定されると、古い系列は切り離されます(ただしデータは保持されます)。
© 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.