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 で指定されたスライスがシリーズに追加されたときに発せられる。
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)
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
シリーズの型を返します。
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.