Back to Qt.io
Contact Us Blog Download Qt

PieSeries QML Type

データを円グラフで表示します。もっと見る...

Import Statement: import QtGraphs
In C++: QPieSeries
Inherits:

AbstractSeries

プロパティ

シグナル

メソッド

  • PieSlice append(string label, real value)
  • PieSlice at(int index)
  • clear()
  • PieSlice find(string label)
  • bool remove(PieSlice slice)
  • bool remove(int index)
  • void removeMultiple(int index, int count)
  • bool replace(list<PieSlice> slices)
  • bool replace(PieSlice oldSlice, PieSlice newSlice)
  • bool replace(int index, PieSlice slice)
  • bool take(PieSlice slice)

詳細説明

パイシリーズは、PieSlice 型を用いて定義されたスライスで構成されます。PieSeries型は、グラフ内のスライスの実際のサイズを決定するために、シリーズ内のすべてのスライスの合計と比較したスライスの割合を計算するので、スライスは任意の値を持つことができます。

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

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

次のQMLの例では、簡単な円グラフの作り方を示しています。

PieSlice およびGraphsViewも参照して ください。

プロパティの説明

count : int [read-only]

一連のスライス数。


endAngle : real

パイの終了角度。

完全な円グラフは360度で、0度は12時の方向です。

デフォルト値は 360。


holeSize : real

ドーナツの穴の大きさ。

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

デフォルト値は0.0です。


horizontalPosition : real

パイの水平位置。

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

  • 0.0は絶対左。
  • 1.0 は絶対的な右位置。

デフォルト値は 0.5（中央）。

verticalPositionも参照 。


pieSize : real

パイ・サイズ。

グラフ矩形に対する相対値：

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

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

デフォルト値は 0.7 です。


startAngle : real

パイの開始角度。

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

デフォルト値は 0。


sum : real [read-only]

すべてのスライスの合計。

このシリーズは、保持しているすべてのスライスの合計を記録します。


verticalPosition : real

パイの垂直位置。

グラフの矩形に対する相対値：

  • 0.0は絶対的な一番上。
  • 1.0は絶対的な一番下。

デフォルト値は 0.5（中央）。

horizontalPositionも参照 。


シグナル ドキュメント

added(list<PieSlice> slices)

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

注意: 対応するハンドラはonAdded です。


countChanged()

このシグナルはスライスカウントが変更されたときに発せられます。

注 : 対応するハンドラはonCountChanged です。

countも参照 。


endAngleChanged()

このシグナルは、パイの終了角度が変化したときに発せられます。

注 : 対応するハンドラはonEndAngleChanged です。

endAngleも参照 。


holeSizeChanged()

このシグナルは、ドーナツの穴の大きさが変化したときに発せられます。

注 ：対応するハンドラはonHoleSizeChanged 。

holeSizeも参照 。


horizontalPositionChanged()

このシグナルは水平位置が変化したときに発せられる。

注 ：対応するハンドラはonHorizontalPositionChanged 。

horizontalPositionも参照 。


pieSizeChanged()

このシグナルは、パイのサイズが変化したときに発せられます。

注意 : 対応するハンドラはonPieSizeChanged です。

pieSizeも参照して ください。


removed(list<PieSlice> slices)

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

注： 対応するハンドラはonRemoved 。


startAngleChanged()

このシグナルは、パイの開始角度が変更されたときに発行されます。

注 : 対応するハンドラはonStartAngleChanged です。

startAngleも参照 。


sumChanged()

このシグナルは、すべてのスライスの合計が変化したときに発せられます。

注意 : 対応するハンドラはonSumChanged です。

sumも参照して ください。


verticalPositionChanged()

このシグナルは垂直位置が変化したときに発せられます。

注意 : 対応するハンドラはonVerticalPositionChanged です。

verticalPositionも参照 。


メソッドの説明

PieSlice append(string label, real value)

ラベルがlabel で値がvalue の新しいスライスをパイに追加します。


PieSlice at(int index)

index で指定された位置のスライスを返します。インデックスが有効でない場合は null を返します。


clear()

パイからすべてのスライスを削除します。


PieSlice find(string label)

ラベルlabel を持つ最初のスライスを返します。ラベルが見つからない場合は null を返します。


bool remove(PieSlice slice)

slice で指定されたスライスをパイから削除します。削除に成功した場合はtrue を、失敗した場合はfalse を返す。


bool remove(int index)

index で指定されたスライスをパイから削除します。削除に成功した場合はtrue を、失敗した場合はfalse を返す。


void removeMultiple(int index, int count)

index とcount で指定された範囲のスライスを削除します。この呼び出しは、1つのスライスの削除に失敗しても、すべてのスライスを走査します。


bool replace(list<PieSlice> slices)

現在のすべてのスライスをslices で完全に置き換えます。サイズは一致する必要はない。slices のPieSlice のいずれかが無効な場合は false を返す。


bool replace(PieSlice oldSlice, PieSlice newSlice)

oldSlice で指定されたスライスを newSlice で置き換えます。削除に成功した場合はtrue を返し、そうでない場合はfalse を返します。oldSlice は、削除に成功した場合は破棄されます。


bool replace(int index, PieSlice slice)

index のパイからslice で指定されたスライスを置き換えます。置換が成功した場合はtrue を返し、そうでない場合はfalse を返します。


bool take(PieSlice slice)

slice で指定された単一のスライスを系列から取り出します。スライスオブジェクトは削除しません。成功すればtrue を返します。


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