このページでは

VPieModelMapper QML Type

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

Import Statement: import QtCharts 2.12
In C++: QVPieModelMapper
Status: Deprecated

この型は非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

詳細な説明

モデルマッパーを使用すると、QAbstractItemModel クラスから派生したデータモデルを、チャートのデータソースとして利用できます。垂直モデルマッパーは、データモデルとPieSeries 間の関連付けを作成するために使用され、これにより、データモデルの各行が円グラフのスライスを定義し、各列がスライスのラベルまたは値に対応付けられます。

データの操作には、モデルプロパティとパイ・シリーズのプロパティの両方を使用できます。モデルマッパーは、パイ・シリーズとデータモデルを同期させます。

以下の QML の例では、4 つのスライスを持つパイシリーズを作成しています(モデルに少なくとも 5 行があることを前提としています)。各スライスは、1 列目からラベルを、2 列目から値を取得します。

VPieModelMapper {
    series: pieSeries
    model: customModel
    labelsColumn: 1
    valuesColumn: 2
    firstRow: 1
    rowCount: 4
}

プロパティのドキュメント

firstRow : int

最初のスライス値を含むモデルの行。デフォルト値は 0 です。

labelsColumn : int

円グラフのスライスのラベルと同期されるモデルの列。デフォルト値は -1(無効なマッピング)です。

model : SomeModel

マッパーで使用されるQAbstractItemModel ベースのモデルです。このモデルを実装し、QMLから利用できるようにする必要があります。

注:このモデルは 、行や列の追加・削除、およびセル内のデータの変更に対応している必要があります。

rowCount : int

円グラフシリーズ用のデータとしてマッピングされるモデルの行数。デフォルト値は -1 です(行数はモデルの行数によって制限されます)。

series : PieSeries

マッパーで使用されるPieSeriesです。Mapper要素をPieSeriesの子要素として定義する場合は、このプロパティを未定義のままにしてください。マッパーに設定されると、そのシリーズ内のデータはすべて破棄されます。新しいシリーズが指定されると、古いシリーズとの接続は解除されます(ただし、データは保持されます)。

valuesColumn : int

パイチャートの各スライスの値と同期されるモデルの列。デフォルト値は -1(無効なマッピング)です。

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