HBarModelMapper QML Type
棒グラフシリーズ用の水平型マッパー。詳細...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QHBarModelMapper |
| Status: | Deprecated |
このタイプは非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
- 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.