PieSeries QML Type

用饼图展示数据。更多

• 所有成员的列表，包括继承成员
• PieSeries 是Qt Graphs QML Types for 2D 的一部分。

属性

• angleSpanLabelVisibility : enumeration (since 6.10)
• angleSpanVisibleLimit : real (since 6.10)
• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• pieSize : real
• startAngle : real
• sum : real
• verticalPosition : real

信号

• added(list<PieSlice> slices)
• angleSpanLabelVisibilityChanged(LabelVisibility visibility) (since 6.10)
• angleSpanVisibleLimitChanged(real limit) (since 6.10)
• clicked(PieSlice slice)
• countChanged()
• doubleClicked(PieSlice slice)
• endAngleChanged()
• holeSizeChanged()
• horizontalPositionChanged()
• pieSizeChanged()
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• startAngleChanged()
• sumChanged()
• verticalPositionChanged()

方法

• PieSlice append(string label, real value)
• PieSlice at(int index)
• void 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 示例展示了如何创建一个简单的饼图。

import QtQuick
import QtGraphs

Item {
    id: mainView
    width: 1280
    height: 720

    GraphsView {
        anchors.fill: parent
        theme: GraphsTheme {
             colorScheme: GraphsTheme.ColorScheme.Dark
             theme: GraphsTheme.Theme.QtGreen
        }
        PieSeries {
            id: pieSeries
            PieSlice {
                value: 1
            }
            PieSlice {
                value: 2
            }
        }
    }
}

另请参阅 PieSlice 和GraphsView 。

属性文档

angleSpanLabelVisibility : enumeration [since 6.10]

标签可见性模式。

如果标签位于angleSpanVisibleLimit 设置的角度跨度限制之下，则该模式将决定隐藏哪些标签。如果未设置angleSpanVisibleLimit ，则该模式无效。

此属性在 Qt 6.10 中引入。

另请参阅 angleSpanVisibleLimit 。

angleSpanVisibleLimit : real [since 6.10]

标签可见度的角度跨度限制。

用作切片标签可见度限制的角度跨度。角度跨度小于此值的切片将根据angleSpanLabelVisibility 系列的设置改变其可见性。默认值为0 ，这意味着无论angleSpanLabelVisibility ，都不会隐藏任何切片。

此属性在 Qt 6.10 中引入。

另请参阅 angleSpanLabelVisibility 。

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 指定的切片添加到系列时，将发出该信号。

[since 6.10] angleSpanLabelVisibilityChanged(LabelVisibility visibility)

当角度跨度限制的可见模式发生变化时，将发出该信号。visibility 参数包含新的可见模式。

此信号在 Qt 6.10 中引入。

[since 6.10] angleSpanVisibleLimitChanged(real limit)

该信号在角度跨度限值发生变化时发出。limit 参数包含新的限值。

此信号在 Qt 6.10 中引入。

clicked(PieSlice slice)

当点击或轻触slice 时会发出该信号。

countChanged()

切片计数发生变化时会发出该信号。

另请参见 count 。

doubleClicked(PieSlice slice)

当slice 被双击或双击时会发出该信号。该信号总是出现在clicked 之后。

endAngleChanged()

饼端角发生变化时会发出该信号。

另请参见 endAngle 。

holeSizeChanged()

当甜甜圈孔的大小发生变化时会发出该信号。

另请参见 holeSize 。

horizontalPositionChanged()

水平位置发生变化时会发出该信号。

另请参见 horizontalPosition 。

pieSizeChanged()

饼的大小发生变化时会发出此信号。

另请参见 pieSize 。

pressed(PieSlice slice)

当用户点击或轻触slice 并按住鼠标键或手势时，就会发出该信号。

released(PieSlice slice)

当用户在slice 上释放先前按下的鼠标按钮或手势时，将发出该信号。

removed(list<PieSlice> slices)

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

startAngleChanged()

饼的起始角度发生变化时会发出该信号。

另请参见 startAngle 。

sumChanged()

当所有切片的总和发生变化时会发出该信号。

另请参见 sum 。

verticalPositionChanged()

垂直位置发生变化时会发出该信号。

另请参阅 verticalPosition 。

方法文档

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 。

bool remove(int index)

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

void removeMultiple(int index, int count)

移除index 和count 指定范围的切片。即使删除一个片段失败，也会遍历所有片段。

bool replace(list<PieSlice> slices)

用slices 完全取代当前的所有切片。大小无需匹配。如果slices 中的任何PieSlice 无效，则返回 false。

bool replace(PieSlice oldSlice, PieSlice newSlice)

用 newSlice 替换oldSlice 指定的切片。如果删除成功，则返回true ，否则返回false 。如果删除成功，则销毁oldSlice 。

bool replace(int index, PieSlice slice)

从index 的派中替换slice 指定的切片。如果替换成功，则返回true ，否则返回false 。

bool take(PieSlice slice)

从序列中提取slice 指定的单个切片。不会删除切片对象。如果成功，则返回true 。