BarModelMapper QML Type
棒グラフシリーズ用のモデルマッパー。詳細...
| Import Statement: | import QtGraphs |
| In C++: | QBarModelMapper |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- BarModelMapperは、Qt Graphs の2D用QMLタイプの一部です。
プロパティ
- count : qsizetype
- first : qsizetype
- firstBarSetSection : qsizetype
- lastBarSetSection : qsizetype
- model : model
- orientation : orientation
- series : BarSeries
信号
- countChanged()
- firstBarSetSectionChanged()
- firstChanged()
- lastBarSetSectionChanged()
- modelChanged()
- orientationChanged()
- orientationChanged()
- seriesChanged()
詳細な説明
BarModelMapper 型を使用すると、QAbstractItemModel クラスから派生したデータモデルをグラフのデータソースとして利用できます。モデルマッパーは、データモデルとQBarSeries との間を接続するために使用されます。データモデルを実装し、それを QML に公開する必要があります。
データの操作には、モデルプロパティとバーシリーズのプロパティの両方を使用できます。モデルマッパーは、バーシリーズとデータモデルを同期させた状態に保ちます。
モデルマッパーは、バーシリーズ内のすべてのバーセットのサイズが等しくなるようにします。したがって、あるバーセットに値を追加または削除すると、バーシリーズ内のすべてのバーセットで同じ変更が行われます。
以下のQMLコードスニペットは、3つのバーセットを持つバーシリーズを作成します(モデルに少なくとも4つの列があることを前提としています)。各バーセットには、1行目から始まるデータが含まれます。バーセットの名前は、列ヘッダーによって定義されます。
BarSeries {
BarModelMapper {
model: myCustomModel // QAbstractItemModel derived implementation
firstBarSetColumn: 1
lastBarSetColumn: 3
firstRow: 1
orientation: Qt.Vertical
}
}プロパティのドキュメント
count : qsizetype
棒グラフのデータとしてマッピングされるモデルの行または列の数。デフォルト値は-1 で、これが最小値でもあります。カウントはモデルの行数/列数によって制限されます。
「orientation」も参照してください 。
first : qsizetype
棒グラフ系列の棒セットの最初の値が含まれる、モデルの行または列。デフォルト値は 0 です。
「orientation」も参照してください 。
firstBarSetSection : qsizetype
最初のバーセットのデータソースとして使用されるモデルのセクション。デフォルト値は -1(無効なマッピング)です。
orientationも参照してください 。
lastBarSetSection : qsizetype
最後のバーセットのデータソースとして使用されるモデルのセクション。デフォルト値は -1(無効なマッピング)です。
「orientation」も参照してください 。
model : model
マッパーで使用されるデータモデルです。このモデルを実装し、QMLから利用できるようにする必要があります。
注:このモデルは 、行や列の追加・削除、およびセル内のデータの変更に対応している必要があります。
orientation : orientation
モデルマッパーに対し、モデルからのデータのマッピング方法を指定します。Qt.Vertical が使用される場合、モデルの各列が棒グラフのセットを定義し、モデルの各行がカテゴリを定義します。Qt.Horizontal に設定された場合、モデルの各行が棒グラフのセットを定義し、モデルの各列がカテゴリを定義します。
series : BarSeries
マッパーで使用されるバーシリーズです。マッパーに設定されると、このシリーズ内のデータはすべて破棄されます。新しいシリーズが指定されると、古いシリーズは切り離されますが、そのデータは保持されます。
Signal ドキュメント
countChanged()
このシグナルは、行数または列数が変更されたときに発生します。
注: 対応するハンドラは onCountChanged です。
firstBarSetSectionChanged()
このシグナルは、最初のバーセットセクションが変更されたときに発行されます。
注: 対応するハンドラは onFirstBarSetSectionChanged です。
firstChanged()
このシグナルは、最初の行または列が変更されたときに発生します。
注: 対応するハンドラは onFirstChanged です。
lastBarSetSectionChanged()
このシグナルは、最後のバーセットセクションが変更されたときに発信されます。
注: 対応するハンドラは onLastBarSetSectionChanged です。
modelChanged()
このシグナルは、マッパーが接続されているモデルが変更された際に発火します。
注: 対応するハンドラは onModelChanged です。
orientationChanged()
このシグナルは、向きが変化したときに発せられます。
注: 対応するハンドラは onOrientationChanged です。
orientationChanged()
このシグナルは、向きが変化したときに発せられます。
注: 対応するハンドラは onOrientationChanged です。
seriesChanged()
このシグナルは、マッパーが接続されているバーシリーズが変更されたときに発火します。
注: 対応するハンドラは onSeriesChanged です。
© 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.