PieModelMapper QML Type
円グラフシリーズ用のモデルマッパー。詳細...
| Import Statement: | import QtGraphs |
| In C++: | QPieModelMapper |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- PieModelMapperは、Qt Graphs の2D用QMLタイプの一部です。
プロパティ
- count : qsizetype
- first : qsizetype
- labelsSection : qsizetype
- model : model
- orientation : orientation
- series : PieSeries
- valuesSection : qsizetype
信号
- countChanged()
- firstChanged()
- labelsSectionChanged()
- modelChanged()
- orientationChanged()
- seriesChanged()
- valuesSectionChanged()
詳細な説明
モデルマッパーを使用すると、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.