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 指定位置的切片。如果索引无效，则返回空值。

void clear()

从馅饼中移除所有切片。

PieSlice find(string label)

返回具有标签label 的第一个片段。如果找不到标签，则返回空值。

bool remove(PieSlice slice)

从馅饼中移除slice 指定的切片。如果移除成功，则返回true ，否则返回false 。