Struct LinearGauge 

pub struct LinearGauge { /* private fields */ }

Horizontal meter with optional threshold bands and labels.

Differs from ProgressBar in three ways: threshold zones drive the fill colour (success / warning / danger), faint bands paint behind the fill at zone boundaries, and a thumb marker pins the current position over the bar. Threshold ticks and labels above the bar are opt-in via LinearGauge::threshold_label or LinearGauge::show_zone_labels.

ui.add(
    LinearGauge::new(0.42)
        .zones(GaugeZones::new(0.6, 0.85))
        .show_zone_labels(),
);

Implementations

impl LinearGauge

pub fn new(fraction: f32) -> Self

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

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

Bar height in points. Default: 14.

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

Override the bar width. Defaults to ui.available_width().

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

Override the fill colour.

pub fn zones(self, zones: GaugeZones) -> Self

Configure threshold zones. Faint bands paint behind the fill at the boundaries and the fill colour auto-derives from the active zone (success / warning / danger).

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

Add a tick + label above the bar at position (0..=1). Stack multiple calls to register more.

pub fn show_zone_labels(self) -> Self

Convenience: add ticks + labels at the configured zone boundaries, formatting each as a percent. Has no effect unless zones is also set.

pub fn thumb(self, on: bool) -> Self

Whether to draw the thumb marker at the current position. Default: on.

Trait Implementations

impl Clone for LinearGauge

fn clone(&self) -> LinearGauge

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LinearGauge

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

Formats the value using the given formatter.

impl Widget for LinearGauge

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

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