このページでは

HPieModelMapper QML Type

円グラフシリーズ用の水平型マッパー。詳細...

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

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

プロパティ

詳細な説明

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

データの操作には、モデルプロパティと円グラフシリーズのプロパティの両方を使用できます。モデルマッパーは、円グラフシリーズとデータモデルの同期を維持します。

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

HPieModelMapper {
    series: pieSeries
    model: customModel
    labelsRow: 1
    valuesRow: 2
    firstColumn: 1
    columnCount: 4
}

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

columnCount : int

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

firstColumn : int

最初のスライス値が含まれるモデルの列。デフォルト値は 0 です。

labelsRow : int

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

model : SomeModel

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

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

series : PieSeries

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

valuesRow : 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.