QPieSeries Class

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

Header: #include <QPieSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: PieSeries
Inherits: 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 の子である series オブジェクトを構築する。

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

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

append()も参照

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

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

追加に成功した場合は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 を持つ単一のスライスをシリーズに追加します。スライスの所有権はシリーズに渡されます。valueNaNInf-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 の数だけ削除します。 パイスライスは永久に削除されます。

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

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

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

remove()も参照してください

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

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

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

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

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

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

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

位置index にあるPieSliceslice で指定されたものに置き換えます。元の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 に設定する。

注意: この関数は、シリーズ内の現在のスライスのみに影響します。新しいスライスが追加された場合、デフォルトのラベル位置は 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:この系列のすべてのスライス値の合計を返す。

備考: プロパティ 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 で指定されたスライスを系列に追加し、その系列への参照を返す。スライスの所有権はシリーズに渡されます。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。