DonutChart¶

Donut chart with hover and legend.

import QWinUI3.Extras · src/extras/QWinUI3/Extras/DonutChart.qml

Category: Charts & gauges · Library: v2.80

Gallery: DonutChart — src/gallery/pages/DonutChartPage.qml

Extends Control.

Example¶

DonutChart {
    id: donutChart
    slices: [{ value: 3, label: "A"
}] }

// --- API ---
// signals: onSliceClicked
// methods: playReveal(), requestRedraw()
// donutChart.playReveal()
// donutChart.requestRedraw()

Notes¶

Prefer slices: [{ value, label?, color? }]. Convenience values: number[] when slices is empty. Hollow center via thickness; centerText / centerSubText optional. interactive / isInteractive aliases.

API¶

Properties¶

Name	Type	Description
`slices`	`var`	Pie/donut slice descriptors
`values`	`var`	Convenience values when slices is empty (number[] or { value, label?, color? }[])
`thickness`	`real`	Donut ring thickness
`showCenterLabel`	`bool`	Show center label in donut
`centerText`	`string`	Donut center primary text
`centerSubText`	`string`	Donut center secondary text
`showLegend`	`bool`	Show chart legend
`legendPosition`	`string`	Legend placement: "right" (default) or "bottom" (2.65)
`interactive`	`bool`	Enable hover / click interaction
`isInteractive`	`alias`	Alias of interactive (gauge / KPI naming parity)
`animated`	`bool`	Play enter / reveal animation
`animateDataUpdates`	`bool`	Lerp slice values on updates (2.68 B4)
`startAngle`	`real`	Arc start angle in degrees
`revealProgress`	`real`	0..1 reveal animation progress
`dataProgress`	`real`	—
`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):

padding
font
background / contentItem

Generated from module sources by scripts/generate_component_docs.py — do not edit by hand.