QPieSeries Class
QPieSeries クラスは、データを円グラフで表示します。詳細...
| Header: | #include <QPieSeries> |
| In QML: | PieSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
このクラスは非推奨となっています。新しいコードでの使用は強く推奨しません。
プロパティ
|
|
パブリック関数
| QPieSeries(QObject *parent = nullptr) | |
| virtual | ~QPieSeries() |
| bool | append(QPieSlice *slice) |
| bool | append(const QList<QPieSlice *> &slices) |
| QPieSlice * | append(const QString &label, qreal value) |
| void | clear() |
| int | count() const |
| qreal | holeSize() const |
| qreal | horizontalPosition() const |
| bool | insert(int index, QPieSlice *slice) |
| bool | isEmpty() const |
| qreal | pieEndAngle() const |
| qreal | pieSize() const |
| qreal | pieStartAngle() const |
| bool | remove(QPieSlice *slice) |
| void | setHoleSize(qreal holeSize) |
| void | setHorizontalPosition(qreal relativePosition) |
| void | setLabelsPosition(QPieSlice::LabelPosition position) |
| void | setLabelsVisible(bool visible = true) |
| void | setPieEndAngle(qreal angle) |
| void | setPieSize(qreal relativeSize) |
| void | setPieStartAngle(qreal startAngle) |
| void | setVerticalPosition(qreal relativePosition) |
| QList<QPieSlice *> | slices() const |
| qreal | sum() const |
| bool | take(QPieSlice *slice) |
| qreal | verticalPosition() const |
| QPieSeries & | operator<<(QPieSlice *slice) |
再実装されたパブリック関数
| virtual QAbstractSeries::SeriesType | type() const override |
シグナル
| void | added(const QList<QPieSlice *> &slices) |
| void | clicked(QPieSlice *slice) |
| void | countChanged() |
| void | doubleClicked(QPieSlice *slice) |
| void | hovered(QPieSlice *slice, bool state) |
| void | pressed(QPieSlice *slice) |
| void | released(QPieSlice *slice) |
| void | removed(const QList<QPieSlice *> &slices) |
| void | sumChanged() |
詳細な説明
パイシリーズは、QPieSlice オブジェクトとして定義されたスライスで構成されます。スライスには任意の値を指定できます。QPieSeriesオブジェクトは、シリーズ内のすべてのスライスの合計に対する各スライスの割合を計算し、チャート上のスライスの実際のサイズを決定します。
円グラフのサイズとチャート上の位置は、0.0 から 1.0 の範囲の相対値を使用して制御されます。これらは、実際のチャート矩形に関連付けられています。
デフォルトでは、円グラフは完全な円として定義されます。シリーズに対して開始角度と角度範囲を設定することで、部分的な円グラフを作成できます。完全な円グラフは 360 度で、0 度は 12 時の位置になります。
QPieSeries の使用方法については、「ウィジェット付きグラフギャラリー」を参照してください。


QPieSlice およびQChartも参照してください 。
プロパティのドキュメント
[read-only] count : int
このプロパティは、シリーズに含まれるスライスの数を保持します。
アクセス関数:
| int | count() const |
通知シグナル:
| void | countChanged() |
endAngle : qreal
このプロパティは、円グラフの終了角度を保持します。
円グラフの全角は360度で、0度は12時の位置にあたります。
デフォルト値は360です。
アクセス関数:
| qreal | pieEndAngle() const |
| void | setPieEndAngle(qreal angle) |
holeSize : qreal
このプロパティには、ドーナツホールのサイズが格納されます。
この値はチャートの矩形を基準としているため、次のようになります。
- 0.0 は最小サイズ(穴のない完全な円グラフ)です。
- 1.0 は、チャートに収まる最大サイズです(ドーナツの幅はありません)。
このプロパティを設定すると、穴のサイズが円グラフのサイズを超えないように、必要に応じてsize プロパティが調整されます。
デフォルト値は 0.0 です。
アクセス関数:
| qreal | holeSize() const |
| void | setHoleSize(qreal holeSize) |
horizontalPosition : qreal
このプロパティは、パイチャートの水平位置を指定します。
この値はチャートの矩形を基準とするため、
- 0.0 は絶対的な左端です。
- 1.0 は絶対的な右端です。
デフォルト値は 0.5(中央)です。
アクセス関数:
| qreal | horizontalPosition() const |
| void | setHorizontalPosition(qreal relativePosition) |
verticalPositionも参照してください 。
size : qreal
このプロパティは、パイのサイズを保持します。
この値はチャートの矩形に対する相対値であるため、次のようになります。
- 0.0 が最小サイズ(円グラフは描画されません)。
- 1.0 は、チャートに収まる最大のサイズです。
このプロパティを設定すると、必要に応じてholeSize プロパティが調整され、穴のサイズが円グラフのサイズを超えないようにします。
デフォルト値は 0.7 です。
アクセス関数:
| qreal | pieSize() const |
| void | setPieSize(qreal relativeSize) |
startAngle : qreal
このプロパティには、円グラフの開始角度が格納されます。
円グラフの全周は360度で、0度は12時の位置にあたります。
デフォルト値は 0 です。
アクセス関数:
| qreal | pieStartAngle() const |
| void | setPieStartAngle(qreal startAngle) |
[read-only] sum : qreal
このプロパティには、すべてのスライスの合計値が格納されます。
この系列は、自身が保持するすべてのスライスの合計を追跡します。
アクセス関数:
| qreal | sum() const |
通知シグナル:
| void | sumChanged() |
verticalPosition : qreal
このプロパティは、パイチャートの垂直位置を指定します。
この値はチャートの矩形を基準とするため、
- 0.0 は絶対的な最上部です。
- 1.0 は絶対的な最下部です。
デフォルト値は 0.5(中央)です。
アクセス関数:
| qreal | verticalPosition() const |
| void | setVerticalPosition(qreal relativePosition) |
horizontalPositionも参照してください 。
メンバ関数のドキュメント
[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)
parent の子となるシリーズオブジェクトを作成します。
[virtual noexcept] QPieSeries::~QPieSeries()
円グラフとその各セグメントを削除します。
[signal] void QPieSeries::added(const QList<QPieSlice *> &slices)
このシグナルは、slices で指定されたスライスがシリーズに追加されたときに発せられます。
append() およびinsert()も参照してください 。
bool QPieSeries::append(QPieSlice *slice)
slice で指定されたスライスをシリーズに追加します。スライスの所有権はシリーズに渡されます。
追加に成功した場合、true を返します。
bool QPieSeries::append(const QList<QPieSlice *> &slices)
slices で指定されたスライスの配列を、シリーズに追加します。スライスの所有権はシリーズに渡されます。
追加に成功した場合は、true を返します。
QPieSlice *QPieSeries::append(const QString &label, qreal value)
指定されたvalue およびlabel を持つ単一のスライスを、シリーズに追加します。スライスの所有権はシリーズに渡されます。value がNaN 、Inf 、または-Inf の場合、nullを返し、シリーズには何も追加しません。
void QPieSeries::clear()
シリーズからすべてのスライスを削除します。
[signal] void QPieSeries::clicked(QPieSlice *slice)
このシグナルは、slice で指定されたスライスがクリックされたときに発火します。
QPieSlice::clicked()も参照してください 。
int QPieSeries::count() const
この系列に含まれるスライスの数を返します。
注: プロパティ `count`のゲッター 関数です。
[signal] void QPieSeries::countChanged()
このシグナルは、スライス数が変更されたときに発信されます。
注: プロパティ `count` に対する通知 シグナルです。
「count」も参照してください 。
[signal] void QPieSeries::doubleClicked(QPieSlice *slice)
このシグナルは、slice で指定されたスライスをダブルクリックしたときに発生します。
QPieSlice::doubleClicked()も参照してください 。
[signal] void QPieSeries::hovered(QPieSlice *slice, bool state)
このシグナルは、slice で指定されたスライスにマウスをホバーさせたときに発火します。マウスがスライスの上を移動すると、state はtrue に変わり、マウスが再びスライスから離れると、false に変わります。
QPieSlice::hovered()も参照してください 。
bool QPieSeries::insert(int index, QPieSlice *slice)
slice で指定されたスライスを、index で指定された位置にあるスライスの前に、シリーズに挿入します。スライスの所有権はシリーズに渡されます。
挿入に成功した場合、true を返します。
bool QPieSeries::isEmpty() const
シリーズが空の場合、true を返します。
qreal QPieSeries::pieEndAngle() const
円グラフの終了角度を返します。
円グラフの全周は360度で、0度は12時の位置にあたります。
注: プロパティ `endAngle`のゲッター 関数です。
関連項目: setPieEndAngle()、pieStartAngle()、およびsetPieStartAngle()。
[signal] void QPieSeries::pressed(QPieSlice *slice)
このシグナルは、ユーザーがslice で指定されたスライスをクリックし、マウスボタンを押し続けたときに発火します。
QPieSlice::pressed()も参照してください 。
[signal] void QPieSeries::released(QPieSlice *slice)
このシグナルは、ユーザーが `slice` で指定されたスライス上のマウスボタンを離したときに発生します。
QPieSlice::released()も参照してください 。
bool QPieSeries::remove(QPieSlice *slice)
slice で指定された単一のスライスをシリーズから削除し、完全に破棄します。
この呼び出し後は、ポインタを参照することはできません。
削除に成功した場合は、true を返します。
[signal] void QPieSeries::removed(const QList<QPieSlice *> &slices)
slices で指定されたスライスがシリーズから削除されたときに、このシグナルが発生します。
remove()も参照してください 。
void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)
すべてのスライスラベルの位置を `position` に設定します。
注:この関数は 、シリーズ内の現在のスライスのみに影響します。新しいスライスが追加された場合、ラベルのデフォルトの位置はQPieSlice::LabelOutside になります。
関連項目: QPieSlice::labelPosition() およびQPieSlice::setLabelPosition()。
void QPieSeries::setLabelsVisible(bool visible = true)
すべてのスライスラベルの表示設定を「visible 」に設定します。
注:この関数は 、シリーズ内の現在のスライスのみに影響します。新しいスライスが追加された場合、ラベルの表示状態のデフォルトはfalse になります。
関連項目: QPieSlice::isLabelVisible() およびQPieSlice::setLabelVisible()。
void QPieSeries::setPieEndAngle(qreal angle)
パイの終了角度を設定します。
円グラフの全範囲は360度で、0度は12時の位置にあたります。
angle 開始角度よりも大きくなければなりません。
注: プロパティ `endAngle`のセッター 関数です。
pieEndAngle()、pieStartAngle()、およびsetPieStartAngle()も参照してください 。
QList<QPieSlice *> QPieSeries::slices() const
この系列に属するスライスのリストを返します。
qreal QPieSeries::sum() const
この系列に含まれるすべてのスライスの値の合計を返します。
注: プロパティ `sum`のゲッター 関数です。
関連項目: QPieSlice::value()、QPieSlice::setValue()、QPieSlice::percentage()。
[signal] void QPieSeries::sumChanged()
このシグナルは、すべてのスライスの合計値が変化したときに発せられます。
注: プロパティ「sum 」の通知 シグナルです。
「sum」も参照してください 。
bool QPieSeries::take(QPieSlice *slice)
slice で指定された、シリーズからの単一のスライスを取得します。スライスオブジェクトは削除されません。
注:シリーズは スライスの親オブジェクトのままとなります。完全な所有権を取得するには、親オブジェクトを設定する必要があります。
take 操作が成功した場合、true を返します。
[override virtual] QAbstractSeries::SeriesType QPieSeries::type() const
プロパティ「QAbstractSeries::type 」のアクセス関数を再実装します。
系列の型を返します。
QPieSeries &QPieSeries::operator<<(QPieSlice *slice)
slice で指定されたスライスをシリーズに追加し、そのシリーズへの参照を返します。スライスの所有権はシリーズに渡されます。
© 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.