Struct Select 

pub struct Select<'a, T: PartialEq + Clone> { /* private fields */ }

A styled drop-down select.

Bind the selection to any PartialEq + Clone type — an enum, an index, or a String — and supply a list of (value, label) pairs. Labels accept &'static str, String, or any Cow<'a, str>, so static option lists don’t allocate.

#[derive(Clone, PartialEq)]
enum Unit { Us, Ms, S }

let mut unit = Unit::Ms;
ui.add(Select::new("unit", &mut unit).options([
    (Unit::Us, "μs"),
    (Unit::Ms, "ms"),
    (Unit::S,  "s"),
]));

For string-valued selects where each option is both the value and the label, use Select::strings:

let mut unit = String::from("ms");
ui.add(Select::strings("unit", &mut unit, ["us", "ms", "s"]));

Implementations

impl<'a, T: PartialEq + Clone> Select<'a, T>

pub fn new(id_salt: impl Hash, value: &'a mut T) -> Self

Create a select keyed by id_salt and bound to value. Add selectable options via Select::options.

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

Show a label above the select.

pub fn options<I, S>(self, options: I) -> Self

where I: IntoIterator<Item = (T, S)>, S: Into<Cow<'a, str>>,

Set the selectable options as (value, label) pairs. Labels are carried as Cow<'a, str>, so &'static str labels never allocate.

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

Override the select width in points. Defaults to the intrinsic size of the selected label plus padding.

impl<'a> Select<'a, String>

pub fn strings<I, S>( id_salt: impl Hash, value: &'a mut String, options: I, ) -> Self

where I: IntoIterator<Item = S>, S: Into<Cow<'a, str>>,

Convenience constructor for string-valued selects. Each item is used as both the value and the displayed label.

let mut unit = String::from("ms");
ui.add(Select::strings("unit", &mut unit, ["us", "ms", "s"]));

Trait Implementations

impl<'a, T: PartialEq + Clone> Debug for Select<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: PartialEq + Clone> Widget for Select<'a, T>

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

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