PieChart¶
Pie chart with legend.
import QWinUI3.Extras · src/extras/QWinUI3/Extras/PieChart.qml
Category: Charts & gauges · Library: v2.80
Gallery: PieChart — src/gallery/pages/PieChartPage.qml
Extends Control.
Example¶
PieChart {
id: pieChart
slices: [{ value: 1, label: "A"
}] }
// --- API ---
// signals: onSliceClicked
// methods: playReveal(), requestRedraw()
// pieChart.playReveal()
// pieChart.requestRedraw()
Notes¶
Prefer slices: [{ value, label?, color? }]. Convenience values: number[] (or objects) builds the same shape when slices is empty. interactive / isInteractive aliases. showLegend for ChartLegend.
API¶
Properties¶
| Name | Type | Description |
|---|---|---|
slices |
var |
Pie/donut slice descriptors |
values |
var |
Convenience values when slices is empty (number[] or { value, label?, color? }[]) |
showLegend |
bool |
Show chart legend |
interactive |
bool |
Enable hover / click interaction |
isInteractive |
alias |
Alias of interactive (gauge / KPI naming parity) |
animated |
bool |
Play enter / reveal animation |
startAngle |
real |
Arc start angle in degrees |
padAngle |
real |
Padding angle between pie slices |
revealProgress |
real |
0..1 reveal animation progress |
hoverIndex |
int |
Hovered item index |
selectedIndex |
alias |
Selected index alias |
title |
string |
Primary title text |
emptyText |
string |
Placeholder when there is no data |
isEmpty |
bool |
True when there is no data |
total |
real |
Sum of segment values |
Signals¶
| Signature | Description |
|---|---|
sliceClicked(int index, real value) |
Emitted when a slice is clicked |
Methods¶
| Signature | Description |
|---|---|
playReveal() |
Play entrance reveal animation |
requestRedraw() |
Request chart / canvas redraw |
Inherited from Control¶
Also available (base type / Qt Quick Controls):
paddingfontbackground/contentItem
Generated from module sources by scripts/generate_component_docs.py — do not edit by hand.