このページでは

BarModelMapper QML Type

棒グラフシリーズ用のモデルマッパー。詳細...

Import Statement: import QtGraphs
In C++: QBarModelMapper

プロパティ

信号

詳細な説明

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.