Struct Gauge 

pub struct Gauge<'a> { /* private fields */ }

Block-fill gauge builder. Auto-renders on Drop.

Constructed via Context::gauge. Chainable .label, .width, .color methods configure the gauge before it renders. Drop the value to render without capturing a response, or call Self::show to render and obtain a GaugeResponse.

Drop is intentional: ui.gauge(0.5).label("CPU"); is the idiomatic form when the response isn’t needed, mirroring egui’s ui.add(...). Use Self::show when you need the response.

Family

Use LineGauge for a compact single-line bar with a trailing label, or Context::progress_bar / Context::progress for an unlabeled bar.

Implementations

impl<'a> Gauge<'a>

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

Set the centered inline label. Empty string is treated as “no label”.

Accepts both &str and owned String via impl Into<String> so callers with already-owned strings (e.g. format!(...)) don’t pay a redundant clone.

pub fn width(self, w: u32) -> Self

Set the bar width in terminal cells (default: 20).

pub fn color(self, c: Color) -> Self

Override the auto-tiered color with a fixed color.

pub fn show(self) -> GaugeResponse

Render now and return the GaugeResponse.

Trait Implementations

impl Drop for Gauge<'_>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.