PieSlice QML Type
表示饼图系列中的单个扇区。更多...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QPieSlice |
| Status: | Deprecated |
此类型已弃用。我们强烈建议不要在新代码中使用它。
属性
- angleSpan : real
- borderColor : color
- borderWidth : int
- brushFilename : string
- color : color
- explodeDistanceFactor : real
- exploded : bool
- label : string
- labelArmLengthFactor : real
- labelColor : color
- labelFont : font
- labelPosition : enumeration
- labelVisible : bool
- percentage : real
- startAngle : real
- value : real
信号
- clicked()
- doubleClicked()
- hovered(bool state)
- pressed()
- released()
详细说明
每个扇区都有一个数值和一个标签。当该扇区被添加到饼图系列中时，PieSeries 类型会计算该扇区相对于该系列中所有扇区总和的百分比，从而确定该扇区在图表中的实际大小。
默认情况下，标签处于隐藏状态。若标签可见，则可位于扇形外侧并通过连接线与之相连，或水平居中显示于扇形内部，亦或与扇形弧线的切线或法线平行居中显示。
默认情况下，扇区的外观由主题设定，但可以通过指定扇区属性来覆盖该主题。不过，如果在自定义扇区后更改了主题，所有自定义设置都将丢失。
PieSlice 类型应作为PieSeries 类型的子元素使用。例如：
此外，还可以通过调用PieSeries.append()方法将扇区添加到饼图系列中。
在这种情况下，可以使用PieSeries.at() 或PieSeries.find 来访问单个 PieSlice 实例的属性。
另请参阅 PieSeries 。
属性文档
angleSpan : real [read-only]
该扇区的角度范围。一个完整的圆为360度，其中0度位于12点钟方向。该值会在扇区添加到系列后自动更新。
borderColor : color
用于绘制切片边框的颜色（笔色）。
另请参阅 borderWidth 。
borderWidth : int
切片边框的宽度。这是一个用于修改切片笔触的便捷属性。
另请参阅 borderColor 。
brushFilename : string
用作该切片画笔的文件名称。
color : color
切片的填充（笔刷）颜色。
explodeDistanceFactor : real
确定切片从圆饼处向外扩展的距离。
- 1.0 表示该距离等于半径。
- 0.5 表示该距离为半径的一半。
默认情况下，该距离为 0.15
另请参阅 exploded 。
exploded : bool
这块切片是否已从整块馅饼上分离出来。
另请参阅 explodeDistanceFactor 。
label : string
切片的标签。
注意：该 字符串可以使用 HTML 格式。
labelArmLengthFactor : real
标签臂的长度。该系数是相对于饼图半径而言的。例如：
- 1.0 表示该长度与半径相等。
- 0.5 表示该长度为半径的一半。
默认情况下，扇形臂长度为 0.15
另请参阅 labelVisible 。
labelColor : color
用于绘制切片标签的颜色。
labelFont : font
切片标签所用的字体。
有关详细信息，请参阅font 。
另请参阅 labelVisible 和labelPosition 。
labelPosition : enumeration
描述切片标签的位置。
| 常量 | 描述 |
|---|---|
PieSlice.LabelOutside | 标签位于与其通过连接臂相连的切片之外。这是默认值。 |
PieSlice.LabelInsideHorizontal | 标签位于切片中心，并水平排列。 |
PieSlice.LabelInsideTangential | 标签位于切片中心，并旋转至与切片弧的切线平行。 |
PieSlice.LabelInsideNormal | 标签位于切片中心，并旋转至与切片弧的法线平行。 |
另请参阅 labelVisible 。
labelVisible : bool
切片标签的可见性。默认情况下，该标签不可见。
percentage : real [read-only]
该切片占该系列中所有切片总和的百分比。实际值范围为 0.0 到 1.0。一旦将该切片添加到系列中，该值会自动更新。
startAngle : real [read-only]
该切片在其所属系列中的起始角度。一个完整的圆饼为360度，其中0度位于12点钟方向。一旦将该切片添加到系列中，该值会自动更新。
value : real
切片的值。
注意： 负值将转换为正值。
信号文档
clicked()
当点击切片时，会触发此信号。
相应的信号处理程序为onClicked() 。
注意： 相应的处理程序 是onClicked 。
doubleClicked()
当用户双击切片时，会触发此信号。
相应的信号处理程序为onDoubleClicked() 。
注意： 相应的处理程序 是onDoubleClicked 。
hovered(bool state)
当鼠标悬停在切片上时，会触发此信号。当鼠标移到切片上时，state 会变为true ；当鼠标再次移开时，它会变为false 。
相应的信号处理程序是onHovered() 。
注意： 相应的处理程序 是onHovered 。
pressed()
当用户点击切片并按住鼠标按钮时，会触发此信号。
相应的信号处理程序为onPressed() 。
注意： 相应的处理程序 是onPressed 。
released()
当用户松开鼠标按钮时，会触发此信号。
相应的信号处理程序是onReleased() 。
注意： 相应的处理程序 是onReleased 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
