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 はQt Graphs C++ Classes for 2D に含まれます。
プロパティ
|
|
パブリック関数
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)
指定されたvalue とlabel を持つ単一のスライスをシリーズに追加します。スライスの所有権はシリーズに渡されます。value がNaN
,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)
位置index のPieSlice をslice で指定されたものに置き換える。元の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
シリーズの型を返します。
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.