HBarModelMapper QML Type

バーシリーズ用の水平モデルマッパー。詳細...

Import Statement: import QtCharts 2.8
In C++: QHBarModelMapper

プロパティ

詳細説明

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に公開する必要があります。

注: モデルは行や列の追加や削除、セル内のデータの変更をサポートする必要があります。


マッパーが使用する棒系列。シリーズがマッパーに設定されると、シリーズ内のデータは全て破棄されます。新しい系列が指定されると、古い系列は切り離される(ただしデータは保持される)。


© 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.