このページでは

PieModelMapper QML Type

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

Import Statement: import QtGraphs
In C++: QPieModelMapper

プロパティ

信号

詳細な説明

モデルマッパーを使用すると、QAbstractItemModel クラスから派生したデータモデルをグラフのデータソースとして利用できます。モデルマッパーは、データモデルとPieSeries との間に関連付けを作成するために使用されます。

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

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

PieModelMapper {
    series: pieSeries
    model: customModel
    labelsSection: 1
    valuesSection: 2
    first: 1
    count: 4
    orientation: Qt.Vertical
}

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

count : qsizetype

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

「orientation」も参照してください 。

first : qsizetype

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

「orientation」も参照してください 。

labelsSection : qsizetype

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

orientationも参照してください 。

model : model

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

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

orientation : orientation

モデルマッパーに対し、モデルからのデータのマッピング方法を指定します。Qt.Vertical が使用される場合、モデルの各行が円グラフの1つのスライスを定義し、モデルの各列がスライスのラベルまたは値を定義します。Qt.Horizontal に設定された場合、モデルの各列が円グラフの1つのスライスを定義し、モデルの各行がスライスのラベルまたは値を定義します。

デフォルト値はQt.Vertical

series : PieSeries

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

valuesSection : qsizetype

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

orientationも参照してください 。

Signal ドキュメント

countChanged()

このシグナルは、カウントが変化したときに発信されます。

注: 対応するハンドラは onCountChanged です。

firstChanged()

このシグナルは、最初のスライスが変更されたときに発信されます。

注: 対応するハンドラは onFirstChanged です。

labelsSectionChanged()

このシグナルは、ラベルセクションが変更されたときに発信されます。

注: 対応するハンドラは `onLabelsSectionChanged` です。

modelChanged()

このシグナルは、マッパーが接続されているモデルが変更されたときに発火します。

注: 対応するハンドラは onModelChanged です。

orientationChanged()

このシグナルは、向きが変化したときに発信されます。

注: 対応するハンドラは onOrientationChanged です。

seriesChanged()

このシグナルは、マッパーが接続されているシリーズが変更されたときに発せられます。

注: 対応するハンドラは onSeriesChanged です。

valuesSectionChanged()

このシグナルは、values セクションが変更されたときに発せられます。

注: 対応するハンドラは onValuesSectionChanged です。

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