Struct Selector

pub struct Selector(/* private fields */);

Defines the values and ranges selected by a slider.

Selectors are set on the selector property.

Implementations

impl Selector

pub fn value<T: SelectorValue>( selection: impl IntoVar<T>, min: T, max: T, ) -> Self

New with single value thumb of type T that can be set any value in the min..=max range.

pub fn value_with<T>( selection: impl IntoVar<T>, to_offset: impl Fn(&T) -> Factor + Send + 'static, from_offset: impl Fn(Factor) -> T + Send + 'static, ) -> Self

where T: VarValue,

New with a single value thumb of type T.

The value must convert to a normalized factor [0.fct()..=1.fct()] where 0.fct() is the minimum possible value and 1.fct() is the maximum possible value. If a value outside of this range is returned it is clamped to the range and the selection variable is updated back.

pub fn range<T: SelectorValue>( range: impl IntoVar<Range<T>>, min: T, max: T, ) -> Self

New with two value thumbs of type T that can be set any value in the min..=max range.

pub fn range_with<T>( range: impl IntoVar<Range<T>>, to_offset: impl Fn(&T) -> Factor + Send + 'static, from_offset: impl Fn(Factor) -> T + Send + 'static, ) -> Self

where T: VarValue,

New with two values thumbs that define a range of type T.

The conversion closure have the same constraints as value_with.

pub fn many<T: SelectorValue>( many: impl IntoVar<Vec<T>>, min: T, max: T, ) -> Self

New with many value thumbs of type T that can be set any value in the min..=max range.

pub fn many_with<T>( many: impl IntoVar<Vec<T>>, to_offset: impl Fn(&T) -> Factor + Send + 'static, from_offset: impl Fn(Factor) -> T + Send + 'static, ) -> Self

where T: VarValue,

New with many value thumbs of type T.

The conversion closure have the same constraints as value_with.

pub fn nil() -> Self

New with no value thumb.

pub fn to_offset<T: VarValue>(&self, t: &T) -> Option<Factor>

Convert the value to a normalized factor.

If T is not the same type returns None.

pub fn from_offset<T: VarValue>( &self, offset: impl IntoValue<Factor>, ) -> Option<T>

Convert the normalized factor to a value T.

If T is not the same type returns None.

pub fn thumbs(&self) -> Vec<ThumbValue>

Gets the value thumbs.

pub fn set( &self, nearest_thumb: impl IntoValue<Factor>, to: impl IntoValue<Factor>, )

Move the nearest_thumb to a new offset.

Note that ranges don’t invert, this operation may swap the thumb roles.

pub fn selection(&self) -> BoxedAnyVar

The selection var.

Downcast to T or Range<T> to get and set the value.

Trait Implementations

impl Clone for Selector

fn clone(&self) -> Selector

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Selector

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

Formats the value using the given formatter.

impl PartialEq for Selector

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.