PieSeries QML Type

データを円グラフで表示します。詳細...

この型は非推奨です。新しいコードでの使用は強くお勧めしません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• size : real
• startAngle : real
• sum : real
• verticalPosition : real

信号

• added(list<PieSlice> slices)
• clicked(PieSlice slice)
• doubleClicked(PieSlice slice)
• hovered(PieSlice slice, bool state)
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• sliceAdded(PieSlice slice)
• sliceRemoved(PieSlice slice)

方法

• PieSlice append(string label, real value)
• PieSlice at(int index)
• void clear()
• PieSlice find(string label)
• bool remove(PieSlice slice)

詳細な説明

円グラフのシリーズは、PieSlice 型を使用して定義されたスライスで構成されます。PieSeries型は、シリーズ内の全スライスの合計に対する各スライスの割合を計算し、グラフ上のスライスの実際のサイズを決定するため、スライスには任意の値を指定できます。

円グラフのサイズとチャート上の位置は、0.0 から 1.0 の範囲の相対値を使用して制御されます。これらは、実際のチャート矩形に関連付けられています。

デフォルトでは、円グラフは完全な円として定義されます。開始角度と角度範囲をシリーズに設定することで、部分的な円グラフを作成できます。完全な円グラフは360度で、0度は12時の位置になります。

以下の QML の例は、簡単な円グラフを作成する方法を示しています。

ChartView {
    id: chart
    title: "Top-5 car brand shares in Finland"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    property variant othersSlice: 0

    PieSeries {
        id: pieSeries
        PieSlice { label: "Volkswagen"; value: 13.5 }
        PieSlice { label: "Toyota"; value: 10.9 }
        PieSlice { label: "Ford"; value: 8.6 }
        PieSlice { label: "Skoda"; value: 8.2 }
        PieSlice { label: "Volvo"; value: 6.8 }
    }

    Component.onCompleted: {
        // You can also manipulate slices dynamically, like append a slice or set a slice exploded
        othersSlice = pieSeries.append("Others", 52.0);
        pieSeries.find("Volkswagen").exploded = true;
    }
}

関連項目： PieSlice およびChartView 。

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

count : int [read-only]

この系列に含まれるスライスの数。

endAngle : real

円グラフの終端角。

円全体は360度で、0度は12時の位置にあたります。

デフォルト値は360です。

holeSize : real

ドーナツホールのサイズ。

この値はチャートの矩形に対する相対値であるため、

• 0.0 は最小サイズ（穴のない完全な円グラフ）です。
• 1.0 は、チャートに収まる最大サイズです（ドーナツの幅はありません）。

このプロパティを設定すると、穴のサイズが円グラフのサイズを超えないように、必要に応じてsize プロパティが調整されます。

デフォルト値は 0.0 です。

horizontalPosition : real

パイの水平位置。

この値はチャートの矩形を基準とした相対値であるため、次のようになります：

• 0.0 は絶対的な左端です。
• 1.0 は絶対的な右端です。

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

verticalPositionも参照してください 。

size : 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 です。

clicked(PieSlice slice)

このシグナルは、slice で指定されたスライスがクリックされたときに発生します。

対応するシグナルハンドラは `onClicked` です。

doubleClicked(PieSlice slice)

このシグナルは、slice で指定されたスライスをダブルクリックしたときに発生します。

対応するシグナルハンドラは `onDoubleClicked` です。

hovered(PieSlice slice, bool state)

このシグナルは、slice で指定されたスライスにマウスをホバーさせたときに発生します。マウスがスライスの上を移動すると、state はtrue に変わり、マウスが再びスライスから離れると、false に変わります。

対応するシグナルハンドラはonHovered です。

pressed(PieSlice slice)

このシグナルは、ユーザーが `slice ` で指定されたスライスをクリックし、マウスボタンを押し続けたときに発生します。

対応するシグナルハンドラは `onPressed` です。

released(PieSlice slice)

このシグナルは、ユーザーがslice で指定されたスライス上でマウスのクリックを解除したときに発生します。

対応するシグナルハンドラはonReleased です。

removed(list<PieSlice> slices)

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

対応するシグナルハンドラはonRemoved です。

sliceAdded(PieSlice slice)

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

対応するシグナルハンドラはonSliceAdded です。

sliceRemoved(PieSlice slice)

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

対応するシグナルハンドラはonSliceRemoved です。

メソッドのドキュメント

PieSlice append(string label, real value)

「label 」というラベルと「value 」という値を持つ新しいスライスを円グラフに追加します。

PieSlice at(int index)

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

void clear()

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

PieSlice find(string label)

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

bool remove(PieSlice slice)

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