Struct ProgressRing 

pub struct ProgressRing { /* private fields */ }

A themed determinate circular progress indicator.

// Default: 56 pt diameter, sky arc, percent in the centre.
ui.add(ProgressRing::new(0.42));

// Larger, green, custom centre text + sub-caption.
ui.add(
    ProgressRing::new(0.6)
        .size(88.0)
        .accent(Accent::Green)
        .text("12 / 20")
        .caption("files"),
);

// Hide the centre text entirely with an empty override.
ui.add(ProgressRing::new(0.3).size(32.0).text(""));

Implementations

impl ProgressRing

pub fn new(fraction: f32) -> Self

Create a ring at fraction (0..=1). NaN and out-of-range values are clamped.

pub fn size(self, size: f32) -> Self

Outer diameter in points. Default: 56. Clamped to at least 8.

pub fn stroke_width(self, width: f32) -> Self

Arc stroke thickness in points. Defaults to ~8 % of size, clamped to [3.0, 10.0].

pub fn color(self, color: Color32) -> Self

Paint the arc with an explicit colour. Clears any previously set accent.

pub fn accent(self, accent: Accent) -> Self

Pick the arc colour from one of the theme’s accents. Clears any previously set explicit colour. Default: the theme’s sky.

pub fn text(self, text: impl Into<String>) -> Self

Override the centre text. By default the ring shows the rounded percent (e.g. “42%”) once size >= 40; passing "" hides the text entirely.

pub fn caption(self, caption: impl Into<String>) -> Self

Add a small muted sub-caption below the primary text.

Trait Implementations

impl Clone for ProgressRing

fn clone(&self) -> ProgressRing

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProgressRing

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Widget for ProgressRing

fn ui(self, ui: &mut Ui) -> Response

Allocate space, interact, paint, and return a Response.