饼图系列 QML 类型

以饼图形式展示数据。更多...

导入声明	import QtCharts 2.7
实例化	QPieSeries
继承	AbstractSeries

所有成员的列表，包括继承的成员

属性

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)
clear()
PieSlice find(string label)
bool remove(PieSlice slice)

详细描述

饼图系列由使用 PieSlice 类型定义的切片组成。切片可以具有任何值，因为饼图系列将切片的百分比与系列中所有切片的总和相比较以确定图表中切片的实际大小。

饼图大小和在图表中的位置通过使用从 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 [只读]

系列中切片的数量。

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 [只读]

所有切片的总和。

系列记录它所持有的所有切片的总和。

verticalPosition : real

饼图的垂直位置。

值相对于图表矩形，所以

0.0是绝对顶部。
1.0是绝对底部。

默认值为0.5（居中）。

另请参阅horizontalPosition。

信号文档

added(list<PieSlice> slices)

当指定由slices所指定的切片被添加到系列中时，发出此信号。

相应的信号处理器是onAdded。

注意：相应的处理器是onAdded。

clicked(PieSlice slice)

当指定由slice所指定的切片被点击时，发出此信号。

相应的信号处理器是onClicked。

注意：相应的处理器是onClicked。

doubleClicked(PieSlice slice)

当指定由slice所指定的切片被双击时，发出此信号。

相应的信号处理器是onDoubleClicked。

注意：相应的处理器是onDoubleClicked。

hovered(PieSlice slice, bool state)

当鼠标悬停在被指定为slice的切片上时，会发出此信号。当鼠标移到切片上时，state变为true，当鼠标再次移开时，变为false。

相应的信号处理器是onHovered。

注意：相应的处理器是onHovered。

pressedPieSliceslice

当用户点击指定为slice的切片并按下鼠标按钮时，会发出此信号。

相应的信号处理器是onPressed。

注意：相应的处理器是onPressed。

releasedPieSliceslice

当用户释放指定为slice的切片上的鼠标按钮时，会发出此信号。

相应的信号处理器是onReleased。

注意：相应的处理器是onReleased。

removedlist><PieSlice>slices

当指定为slices的切片从序列中移除时，会发出此信号。

相应的信号处理器是onRemoved。

注意：相应的处理器是onRemoved。

sliceAddedPieSliceslice

当指定为slice的切片被添加到序列中时，会发出此信号。

相应的信号处理器是onSliceAdded。

注意：相应的处理器是onSliceAdded。

sliceRemovedPieSliceslice

当指定为slice的切片从序列中移除时，会发出此信号。

相应的信号处理器是onSliceRemoved。

注意：相应的处理器是onSliceRemoved。

方法文档

PieSliceappendstringlabel，realvalue

向饼图添加一个标签为label，值为value的新切片。

PieSliceatintindex

返回指定位置为index的切片。如果索引无效，则返回null。

clear()

从饼图中移除所有切片。

PieSlicefindstringlabel

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

boolremovePieSliceslice

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