このページでは

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 の使用方法については、「ウィジェット付きグラフギャラリー」を参照してください。

1つのセグメントが切り取られて「Joe」とラベルが付けられた円グラフ

レモングレーズの栄養成分を表したドーナツチャート。タンパク質、脂質、その他、炭水化物の各セグメントがあり、脂質の割合が際立っている

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.