QPieSeries Class

QPieSeries クラスは、円グラフでデータを表示します。詳細...

Header: #include <QPieSeries>
In QML: PieSeries
Inherits: QAbstractSeries

プロパティ

パブリック関数

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の使い方はウィジェットギャラリーのCharts with Widgetsを参照してください。

QPieSlice およびQChartも参照してください

プロパティ・ドキュメンテーション

[read-only] count : const 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 : const 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)

指定されたvaluelabel を持つ単一のスライスをシリーズに追加します。スライスの所有権はシリーズに渡されます。valueNaN,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 で指定されたスライス上にマウスが置かれたときに発せられる。マウスがスライス上に移動するとstatetrue に変わり、再びマウスが離れるとfalse に変わります。

QPieSlice::hovered()も参照してください

bool QPieSeries::insert(int index, QPieSlice *slice)

index で指定された位置のスライスの前に、slice で指定されたスライスをシリーズに挿入します。スライスの所有権はシリーズに渡されます。

挿入に成功すれば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 で指定された1つのスライスをシリーズから削除し、永久に削除する。

このポインタはこの呼び出しの後には参照できない。

削除に成功した場合は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 で指定されたスライスを series に追加し、その series への参照を返す。スライスの所有権はシリーズに渡されます。

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