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関数は、このシリーズに属するすべてのスライス値の合計を返します。
注: プロパティ 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 で指定されたスライスを系列に追加し、その系列への参照を返す。スライスの所有権はシリーズに渡されます。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。