QPieSlice 类
QPieSlice 类表示饼图系列中的单个部分。 更多信息...
公共类型
| 枚举 | LabelPosition { LabelOutside, LabelInsideHorizontal, LabelInsideTangential, LabelInsideNormal } |
属性
|
|
公共函数
| QPieSlice(QObject *parent = nullptr) | |
| QPieSlice(QString label, qreal value, QObject *parent = nullptr) | |
| 虚拟 | ~QPieSlice() |
| qreal | angleSpan() const |
| QColor | borderColor() |
| int | borderWidth() |
| QBrush | brush() const |
| QColor | color() |
| qreal | explodeDistanceFactor() const |
| bool | isExploded() const |
| bool | isLabelVisible() const |
| QString | label() const |
| qreal | labelArmLengthFactor() const |
| QBrush | labelBrush() const |
| QColor | labelColor() |
| QFont | labelFont() const |
| QPieSlice::LabelPosition | labelPosition() |
| QPen | pen() const |
| qreal | percentage() const |
| QPieSeries * | series() const |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(int width) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setExplodeDistanceFactor(qreal factor) |
| void | setExploded(bool exploded = true) |
| void | setLabel(QString label) |
| void | setLabelArmLengthFactor(qreal factor) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setLabelFont(const QFont &font) |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
| void | setLabelVisible(bool visible = true) |
| void | setPen(const QPen &pen) |
| void | setValue(qreal value) |
| qreal | startAngle() const |
| qreal | value() const |
信号
| void | angleSpanChanged() |
| void | borderColorChanged() |
| void | borderWidthChanged() |
| void | brushChanged() |
| void | clicked() |
| void | colorChanged() |
| void | doubleClicked() |
| void | hovered(bool state) |
| void | labelBrushChanged() |
| void | labelChanged() |
| void | labelColorChanged() |
| void | labelFontChanged() |
| void | labelVisibleChanged() |
| void | penChanged() |
| void | percentageChanged() |
| void | pressed() |
| void | released() |
| void | startAngleChanged() |
| void | valueChanged() |
详细描述
饼图切片具有值和标签。当切片被添加到饼图系列中时，QPieSeries对象会计算出切片相对于该系列所有切片总和的百分比，以确定图表中切片的实际大小。
默认情况下，标签是隐藏的。如果可见，它可以是位于切片外部并通过臂与之连接，或者在切片内部水平或与切片的切线或法线平行居中。
默认情况下，切片的视觉外观由主题设置，但可以通过指定切片属性来覆盖主题。然而，如果切片自定义之后更改了主题，则所有自定义设置都将丢失。
要启用用户与饼图的交互，当用户点击饼图切片或将其鼠标悬停在其上时，会发出一些基本信号。
另请参阅QPieSeries。
成员类型文档
enum QPieSlice::LabelPosition
此枚举描述了切片标签的位置。
| 常量 | 值 | 描述 |
|---|---|---|
QPieSlice::LabelOutside | 0 | 标签位于切片外部，并通过臂与之连接。这是默认值。 |
QPieSlice::LabelInsideHorizontal | 1 | 标签位于切片内部并水平排列。 |
QPieSlice::LabelInsideTangential | 2 | 标签位于切片内部并旋转到与切片的切线平行。 |
QPieSlice::LabelInsideNormal | 3 | 标签位于切片内部并旋转到与切片的法线平行。 |
属性文档
[只读] angleSpan : const qreal
此属性表示切片的跨度（以度为单位）。一个完整的饼图为360度，其中0度在12点位置。一旦切片被添加到系列中，会自动更新。
访问函数
| qreal | angleSpan() const |
通知信号
| void | angleSpanChanged() |
borderColor : QColor
此属性表示绘制切片边框所用的颜色。这是一个便利属性，用于修改切片笔。
访问函数
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
通知信号
| void | borderColorChanged() |
borderWidth : int
此属性表示切片边的宽度。这是一个便利属性，用于修改切片笔。
访问函数
| int | borderWidth() |
| void | setBorderWidth(int width) |
通知信号
| void | borderWidthChanged() |
brush : QBrush
此属性表示用于填充切片的画笔。
访问函数
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
通知信号
| void | brushChanged() |
color : QColor
此属性表示切片的填充（画笔）颜色。这是一个便利属性，用于修改切片画笔。
访问函数
| QColor | color() |
| void | setColor(QColor color) |
通知信号
| void | colorChanged() |
另请参阅画笔。
explodeDistanceFactor : qreal
确定切片从饼图中分裂的距离。
- 1.0 表示距离与半径相同。
- 0.5 表示距离为半径的一半。
默认情况下，距离为0.15
访问函数
| qreal | explodeDistanceFactor() const |
| void | setExplodeDistanceFactor(qreal factor) |
另请参阅exploded。
exploded : bool
此属性表示切片是否从饼图中分离。
访问函数
| bool | isExploded() const |
| void | setExploded(bool exploded = true) |
label : QString
此属性表示切片的标签。
注意：字符串可以是HTML格式化的。
访问函数
| QString | label() const |
| void | setLabel(QString label) |
通知信号
| void | labelChanged() |
另请参阅labelVisible、labelBrush、labelFont 和 labelArmLengthFactor。
labelArmLengthFactor : qreal
该属性用于存储标签臂的长度。该系数相对于饼图的半径。例如
- 1.0 表示长度与半径相同。
- 0.5 表示长度是半径的一半。
默认情况下，臂长度为 0.15
访问函数
| qreal | labelArmLengthFactor() const |
| void | setLabelArmLengthFactor(qreal factor) |
labelBrush : QBrush
该属性存储用于绘制切片标签和标签臂的画笔。
访问函数
| QBrush | labelBrush() const |
| void | setLabelBrush(const QBrush &brush) |
通知信号
| void | labelBrushChanged() |
labelColor : QColor
该属性存储用于绘制切片标签的颜色。这是修改切片标签画笔的便利属性。
访问函数
| QColor | labelColor() |
| void | setLabelColor(QColor color) |
通知信号
| void | labelColorChanged() |
另请参阅标签画笔。
labelFont : QFont
该属性存储用于绘制标签文本的字体。
访问函数
| QFont | labelFont() const |
| void | setLabelFont(const QFont &font) |
通知信号
| void | labelFontChanged() |
labelPosition : LabelPosition
该属性存储切片标签的位置。
访问函数
| QPieSlice::LabelPosition | labelPosition() |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
labelVisible : bool
该属性存储切片标签的可见性。默认情况下，标签不可见。
访问函数
| bool | isLabelVisible() const |
| void | setLabelVisible(bool visible = true) |
通知信号
| void | labelVisibleChanged() |
pen : QPen
该属性存储用于绘制切片边界的画笔。
访问函数
| QPen | pen() const |
| void | setPen(const QPen &pen) |
通知信号
| void | penChanged() |
[只读] percentage : const qreal
该属性存储切片相对于系列中所有切片总和的百分比。实际值范围为 0.0 至 1.0。切片添加到系列后自动更新。
访问函数
| qreal | percentage() const |
通知信号
| void | percentageChanged() |
另请参阅值和QPieSeries::sum。
[只读] startAngle : const qreal
此属性持有此切片在所属系列中的起始角度。一个完整的饼图为360度，其中0度在12点位置。一旦切片添加到系列中，将自动更新。
访问函数
| qreal | startAngle() const |
通知信号
| void | startAngleChanged() |
value : qreal
此属性持有切片的值。
注意：负值会被转换为正值。
访问函数
| qreal | value() const |
| void | setValue(qreal value) |
通知信号
| void | valueChanged() |
另请参阅：percentage() 和 QPieSeries::sum。
成员函数文档
[显式] QPieSlice::QPieSlice(QObject *parent = nullptr)
使用父对象 parent 构造一个空的切片。
另请参阅：QPieSeries::append() 和 QPieSeries::insert。
QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = nullptr)
使用指定的 value、label 和 parent 构造一个空的切片。
另请参阅：QPieSeries::append() 和 QPieSeries::insert。
[虚拟 noexcept] QPieSlice::~QPieSlice()
移除切片。如果切片已添加到系列中，不应移除。
[信号] void QPieSlice::angleSpanChanged()
当切片的角度范围发生变化时，将发出此信号。
注意：属性 angleSpan 的通知信号。
另请参阅：angleSpan。
[信号] void QPieSlice::borderColorChanged()
切片边框颜色变化时，将发出此信号。
注意：属性 borderColor 的通知信号。
[信号] void QPieSlice::borderWidthChanged()
切片边框宽度变化时，将发出此信号。
注意：属性 borderWidth 的通知信号。
[信号] void QPieSlice::brushChanged()
用于填充切片的画刷发生变化时，将发出此信号。
注意：属性 brush 的通知信号。
另请参阅画笔。
[信号] void QPieSlice::clicked()
当切片被点击时，将发出此信号。
另请参阅：QPieSeries::clicked。
[信号] void QPieSlice::colorChanged()
当切片颜色发生变化时，将发出此信号。
注意：属性 color 的通知信号。
另请参阅画笔。
[信号] void QPieSlice::doubleClicked()
当用户双击切片时，将发出此信号。
另请参阅 QPieSeries::doubleClicked。
[信号] void QPieSlice::hovered(bool state)
当鼠标悬停在切片上时，会触发此信号。当鼠标移至切片上时，state变为true，当鼠标再次移开时，变为false。
另请参阅 QPieSeries::hovered。
[信号] void QPieSlice::labelBrushChanged()
当切片的标签画笔发生变化时，会触发此信号。
注意： 属性labelBrush的更新通知信号。
另请参阅标签画笔。
[信号] void QPieSlice::labelChanged()
当切片标签发生变化时，会触发此信号。
注意： 属性label的更新通知信号。
另请参阅 label。
[信号] void QPieSlice::labelColorChanged()
当切片标签颜色发生变化时，会触发此信号。
注意： 属性labelColor的更新通知信号。
另请参阅 labelColor。
[信号] void QPieSlice::labelFontChanged()
当切片标签字体发生变化时，会触发此信号。
注意： 属性labelFont的更新通知信号。
另请参阅 labelFont。
[信号] void QPieSlice::labelVisibleChanged()
当切片标签的可见性发生变化时，会触发此信号。
注意： 属性labelVisible的更新通知信号。
另请参阅 labelVisible。
[信号] void QPieSlice::penChanged()
当绘制切片边框使用的pen发生变化时，会触发此信号。
注意： 属性pen的更新通知信号。
另请参阅 pen。
[信号] void QPieSlice::percentageChanged()
当切片的百分比发生变化时，会触发此信号。
注意： 属性percentage的更新通知信号。
另请参阅 percentage。
[信号] void QPieSlice::pressed()
当用户单击切片并按下鼠标按钮时，会触发此信号。
另请参阅 QPieSeries::pressed。
[信号] void QPieSlice::released()
当用户在切片上释放鼠标按钮时，会触发此信号。
另请参阅 QPieSeries::released。
QPieSeries *QPieSlice::series() const
返回此片属于的序列。
另请参阅QPieSeries::append。
[信号] void QPieSlice::startAngleChanged()
当切片的起始角度发生变化时，发出此信号。
注意：此信号为属性 startAngle 的通知信号。
另请参阅startAngle。
[信号] void QPieSlice::valueChanged()
当切片值发生变化时，发出此信号。
注意：此信号为属性 value 的通知信号。
另请参阅value。
© 2024Qt公司有限公司。其中包含的文档贡献属于各自所有者的版权。本提供的文档是根据自由软件基金会发布的GNU自由文档许可协议版本1.3条款许可的。Qt及其相应标志是芬兰和/或世界其他地区的Qt公司有限公司和/或其子公司的商标。所有其他商标均属于各自所有者的财产。
