Struct NumberStepper 

pub struct NumberStepper { /* private fields */ }

Number stepper widget with +/- buttons

Implementations

impl NumberStepper

pub fn new(cx: &mut Context<'_, Self>) -> Self

Create a new number stepper

pub fn with_value(self, value: f64) -> Self

Set initial value (builder pattern)

pub fn min(self, min: f64) -> Self

Set minimum value (builder pattern)

pub fn max(self, max: f64) -> Self

Set maximum value (builder pattern)

pub fn step(self, step: f64) -> Self

Set step value for +/- buttons (builder pattern)

pub fn resolution(self, resolution: f64) -> Self

Set value resolution (builder pattern)

Values will snap to (min + n * resolution) where n is an integer. For example, with min=0.5 and resolution=0.25, valid values are 0.5, 0.75, 1.0, 1.25, etc.

pub fn display_precision(self, precision: usize) -> Self

Set display precision - number of decimal places to show (builder pattern)

The displayed value is rounded to this many decimal places. This is independent of the actual stored value.

pub fn theme(self, theme: Theme) -> Self

Set custom theme (builder pattern)

pub fn with_enabled(self, enabled: bool) -> Self

Set enabled state (builder pattern)

pub fn drag_sensitivities(self, normal: f64, fast: f64, slow: f64) -> Self

Set drag sensitivities as value change per pixel (builder pattern)

Each parameter specifies how much the value changes per pixel of mouse movement:

• normal: Value per pixel with no modifier key
• fast: Value per pixel when Shift is held
• slow: Value per pixel when Alt/Option is held

Example for an integer 0-100 range:

.drag_sensitivities(1.0, 10.0, 1.0)  // 1, 10, or 1 unit per pixel

Example for a float with fine control:

.drag_sensitivities(1.0, 2.0, 0.1)  // 10 pixels of slow drag = 1.0 change

pub fn drag_sensitivity(self, value_per_pixel: f64) -> Self

Set normal drag sensitivity, scaling fast (5x) and slow (0.1x) proportionally

pub fn manual_drag_sensitivity(self) -> Self

Disable auto-scaling of drag sensitivity based on widget width (builder pattern)

By default, when both min and max are set, the drag sensitivity is automatically calculated so that dragging across the value display covers the full range. Call this method to use the configured fixed sensitivities instead.

pub fn step_multipliers(self, small: f64, large: f64) -> Self

Set step multipliers for button clicks (builder pattern)

• small: Multiplier when Alt/Option is held (default 0.1)
• large: Multiplier when Shift is held (default 10.0)

Example: For a step of 100, with multipliers (0.01, 10.0):

• Normal click: step by 100
• Alt+click: step by 1 (100 * 0.01)
• Shift+click: step by 1000 (100 * 10.0)

pub fn step_small(self, multiplier: f64) -> Self

Set small step multiplier for Alt/Option + click (builder pattern)

pub fn step_large(self, multiplier: f64) -> Self

Set large step multiplier for Shift + click (builder pattern)

pub fn focus_handle(&self) -> &FocusHandle

Get the focus handle

pub fn is_enabled(&self) -> bool

Check if the stepper is enabled

pub fn set_enabled(&mut self, enabled: bool, cx: &mut Context<'_, Self>)

Set enabled state programmatically

pub fn value(&self) -> f64

Get the current value

pub fn get_min(&self) -> Option<f64>

Get the minimum value constraint

pub fn get_max(&self) -> Option<f64>

Get the maximum value constraint

pub fn get_step(&self) -> Option<f64>

Get the step value for +/- buttons

pub fn get_resolution(&self) -> Option<f64>

Get the value resolution

pub fn get_display_precision(&self) -> Option<usize>

Get the display precision (decimal places)

pub fn set_value(&mut self, value: f64, cx: &mut Context<'_, Self>)

Set value programmatically

Trait Implementations

impl Focusable for NumberStepper

fn focus_handle(&self, _cx: &App) -> FocusHandle

Returns the focus handle associated with this view.

impl Render for NumberStepper

fn render( &mut self, window: &mut Window, cx: &mut Context<'_, Self>, ) -> impl IntoElement

Render this view into an element tree.

impl EventEmitter<NumberStepperEvent> for NumberStepper