QPieSeries Class

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

ヘッダー #include <QPieSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake QT += graphs
QML で PieSeries
継承: QAbstractSeries

プロパティ

パブリック関数

QPieSeries(QObject *parent = nullptr)
bool append(QPieSlice *slice)
bool append(const QList<QPieSlice *> &slices)
QPieSlice *append(const QString &label, qreal value)
QPieSlice *at(qsizetype index)
void clear()
qsizetype count() const
qreal endAngle() const
QPieSlice *find(const QString &label)
qreal holeSize() const
qreal horizontalPosition() const
bool insert(qsizetype index, QPieSlice *slice)
bool isEmpty() const
qreal pieSize() const
bool remove(QPieSlice *slice)
bool remove(qsizetype index)
void removeMultiple(qsizetype index, int count)
bool replace(const QList<QPieSlice *> &slices)
bool replace(QPieSlice *oldSlice, QPieSlice *newSlice)
bool replace(qsizetype index, QPieSlice *slice)
void setEndAngle(qreal angle)
void setHoleSize(qreal holeSize)
void setHorizontalPosition(qreal relativePosition)
void setLabelsPosition(QPieSlice::LabelPosition position)
void setLabelsVisible(bool visible)
void setPieSize(qreal relativeSize)
void setStartAngle(qreal angle)
void setVerticalPosition(qreal relativePosition)
QList<QPieSlice *> slices() const
qreal startAngle() 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 countChanged()
void endAngleChanged()
void holeSizeChanged()
void horizontalPositionChanged()
void pieSizeChanged()
void removed(const QList<QPieSlice *> &slices)
void startAngleChanged()
void sumChanged()
void verticalPositionChanged()

詳細説明

パイシリーズは、QPieSlice オブジェクトとして定義されるスライスで構成されます。QPieSeriesオブジェクトは、グラフ内のスライスの実際のサイズを決定するために、シリーズ内のすべてのスライスの合計と比較したスライスの割合を計算するので、スライスは任意の値を持つことができます。

グラフ上のパイのサイズと位置は、0.0から1.0の範囲の相対値を使って制御されます。これらは実際のグラフの矩形に関係する。

デフォルトでは、パイは完全なパイとして定義されています。部分円グラフは、開始角度と角度スパンを設定することで作成できます。完全な円グラフは360度で、午前12時を0とする。

QPieSliceも参照

プロパティ・ドキュメント

[read-only] count : const qsizetype

このプロパティは、シリーズのスライス数を保持する。

アクセス関数

qsizetype count() const

通知シグナル

void countChanged()

endAngle : qreal

この特性は、パイの終了角度を保持する。

完全なパイは360度で、0度は12時の方向である。

デフォルト値は360度です。

アクセス関数:

qreal endAngle() const
void setEndAngle(qreal angle)

通知シグナル:

void endAngleChanged()

holeSize : qreal

このプロパティは、ドーナツの穴のサイズを保持する。

pieSize プロパティを設定する際、必要に応じてこのプロパティが調整され、穴のサイズがパイのサイズより大きくならないようにします。

デフォルト値は0.0である。

アクセス関数

qreal holeSize() const
void setHoleSize(qreal holeSize)

通知シグナル:

void holeSizeChanged()

horizontalPosition : qreal

このプロパティは、パイの水平位置を保持する。

この値はグラフの矩形からの相対値である:

  • 0.0は絶対左。
  • 1.0は絶対右です。

デフォルト値は 0.5(中央)。

アクセス関数:

qreal horizontalPosition() const
void setHorizontalPosition(qreal relativePosition)

通知シグナル:

void horizontalPositionChanged()

verticalPositionも参照のこと

pieSize : qreal

このプロパティはパイのサイズを保持する。

値はグラフの矩形に対する相対値である:

  • 0.0は最小パイサイズ(パイは描画されない)。
  • 1.0はグラフに収まる最大のパイサイズです。

このプロパティを設定すると、必要に応じてholeSize プロパティが調整され、穴のサイズがパイのサイズより大きくならないようにします。

デフォルト値は0.7です。

アクセス関数:

qreal pieSize() const
void setPieSize(qreal relativeSize)

通知シグナル:

void pieSizeChanged()

startAngle : qreal

このプロパティは、パイの開始角度を保持する。

完全なパイは360度で、0度は12時の方向である。

デフォルト値は0である。

アクセス関数:

qreal startAngle() const
void setStartAngle(qreal angle)

通知シグナル:

void startAngleChanged()

[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)

通知シグナル:

void verticalPositionChanged()

horizontalPositionも参照

メンバー関数ドキュメント

[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)

parent の子であるシリーズオブジェクトを構築する。

[signal] void QPieSeries::added(const QList<QPieSlice *> &slices)

このシグナルは、slices で指定されたスライスがシリーズに追加されたときに発せられる。

append()も参照

[invokable] bool QPieSeries::append(QPieSlice *slice)

slice で指定されたスライスをシリーズに追加する。スライスの所有権はシリーズに渡されます。

追加に成功すればtrue を返す。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] bool QPieSeries::append(const QList<QPieSlice *> &slices)

slices で指定されたスライスの配列をシリーズに追加します。スライスの所有権はシリーズに渡されます。

追加に成功すればtrue を返す。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] QPieSlice *QPieSeries::append(const QString &label, qreal value)

指定されたvaluelabel を持つ単一のスライスをシリーズに追加します。スライスの所有権はシリーズに渡されます。valueNaN,Inf,-Inf の場合は null を返し、シリーズに何も追加しない。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] QPieSlice *QPieSeries::at(qsizetype index)

index の位置にあるPieSlice を返す。PieSlice が見つからない場合は null を返す。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QPieSeries::clear()

シリーズからすべてのスライスをクリアします。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

qsizetype QPieSeries::count() const

このシリーズのスライス数を返す。

注: プロパティ count のゲッター関数です。

qreal QPieSeries::endAngle() const

パイの終了角度を返します。

完全なパイは360度で、0度は12時の方向である。

注: プロパティ endAngle のゲッター関数。

setEndAngle(),startAngle(),setStartAngle()も参照

[invokable] QPieSlice *QPieSeries::find(const QString &label)

ラベルlabel を含むPieSlice を検索する。見つかればPieSlice を返し、見つからなければ null を返す。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] bool QPieSeries::insert(qsizetype index, QPieSlice *slice)

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

挿入に成功するとtrue を返す。

注: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

bool QPieSeries::isEmpty() const

シリーズが空の場合はtrue を返す。

[invokable] bool QPieSeries::remove(QPieSlice *slice)

slice で指定された1つのスライスをシリーズから削除し、永久に削除する。

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

削除に成功した場合はtrue を返す。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] bool QPieSeries::remove(qsizetype index)

index にあるPieSlice を削除する。PieSlice は永久に削除される。削除に成功した場合はtrue を返します。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QPieSeries::removeMultiple(qsizetype index, int count)

index から始まるシリーズから、count の数だけ複数の PieSlices を削除します。 PieSlices は永久に削除されます。

注意: この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。

[signal] void QPieSeries::removed(const QList<QPieSlice *> &slices)

このシグナルは、slices で指定されたスライスがシリーズから削除されたときに発せられる。

remove()も参照

[invokable] bool QPieSeries::replace(const QList<QPieSlice *> &slices)

シリーズ内のパイスライスのリスト全体をslices で指定されたリストで置き換えます。元のパイスライスはすべて永久に削除されます。すべての PieSlices の置き換えに成功した場合、true を返します。

注意: この関数は、メタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] bool QPieSeries::replace(QPieSlice *oldSlice, QPieSlice *newSlice)

PieSlice oldSlice newSliceoldSlice は永久に削除されます。置き換えに成功した場合は を返します。true

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] bool QPieSeries::replace(qsizetype index, QPieSlice *slice)

位置indexPieSliceslice で指定されたものに置き換える。元のPieSlice は永久に削除されます。PieSlices の置き換えに失敗した場合はfalse を返します。

注意: この関数はメタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。

void QPieSeries::setEndAngle(qreal angle)

パイの終了角度を設定する。

完全なパイは360度で、0度は12時の方向。

angle は開始角度より大きくなければならない。

注: プロパティendAngle のセッター関数。

endAngle(),startAngle(),setStartAngle()も参照

void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)

すべてのスライスラベルの位置をposition に設定します。

Note: この関数は、シリーズ内の現在のスライスのみに影響します。新しいスライスが追加された場合、デフォルトのラベル位置は QPieSlice::LabelOutside になります。

QPieSlice::labelPosition() およびQPieSlice::setLabelPosition()も参照してください

void QPieSeries::setLabelsVisible(bool visible)

すべてのスライスラベルの可視性をvisible に設定します。

注意: この関数はシリーズ内の現在のスライスのみに影響します。新しいスライスが追加された場合、デフォルトのラベルの可視性はfalse になります。

QPieSlice::isLabelVisible() およびQPieSlice::setLabelVisible()も参照して ください。

void QPieSeries::setStartAngle(qreal angle)

パイの開始角度を設定する。

完全なパイは360度で、0度は12時の方向です。

angle は終了角度より小さくなければならない。

注: プロパティstartAngle のセッター関数。

startAngle(),endAngle(),setEndAngle()も参照

QList<QPieSlice *> QPieSeries::slices() const

このシリーズに属するスライスのリストを返します。

qreal QPieSeries::startAngle() const

パイの開始角度を返します。

完全なパイは360度で、0度は12時の方向である。

注: プロパティ startAngle のゲッター関数。

setStartAngle(),endAngle(),setEndAngle()も参照

qreal QPieSeries::sum() const

このシリーズのすべてのスライス値の合計を返す。

注: プロパティ sum のゲッター関数。

QPieSlice::value(),QPieSlice::setValue(),QPieSlice::percentage()も参照

[invokable] bool QPieSeries::take(QPieSlice *slice)

slice で指定された単一のスライスをシリーズから取り出します。スライスオブジェクトは削除しない。

注意: シリーズはスライスの親オブジェクトのままです。完全な所有権を得るには親オブジェクトを設定する必要があります。

take操作が成功した場合、true を返す。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[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.