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 は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 の子である 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)
指定された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 の数だけ削除します。 パイスライスは永久に削除されます。
注意: この関数はメタオブジェクトシステムおよび 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 oldSlice をnewSlice で置換します。oldSlice は永久に削除されます。置き換えに成功した場合は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 に設定する。
注意: この関数は、シリーズ内の現在のスライスのみに影響します。新しいスライスが追加された場合、デフォルトのラベル位置は 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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。