このページでは

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 が使用されている場合、モデルの各列はバーセットを定義し、モデルの行はカテゴリを定義します。Orientation がQt.Horizontal に設定されている場合、モデルの各行がバーセットを定義し、モデルの列がカテゴリを定義します。

series : BarSeries

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

シグナルドキュメント

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.