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 を持つ単一のスライスをシリーズに追加します。スライスの所有権はシリーズに渡されます。valueNaNInf-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関数は、このシリーズに属するすべてのスライス値の合計を返します。

注: プロパティ 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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。