Struct nannou::ui::widget::ListSelect

pub struct ListSelect<M, D, S> { /* fields omitted */ }

A wrapper around the List widget that handles single and multiple selection logic.

Implementations

impl ListSelect<Single, Down, Dynamic>

pub fn single(num_items: usize) -> ListSelect<Single, Down, Dynamic>

Construct a new ListSelect, allowing one selected item at a time.

impl ListSelect<Multiple, Down, Dynamic>

pub fn multiple(num_items: usize) -> ListSelect<Multiple, Down, Dynamic>

Construct a new ListSelect, allowing multiple selected items.

impl<M, D, S> ListSelect<M, D, S> where
    M: Mode,
    S: ItemSize,
    D: Direction, 

pub fn flow_down(self) -> ListSelect<M, Down, S>

Flows items from top to bottom.

pub fn flow_right(self) -> ListSelect<M, Right, S>

Flows items from left to right.

pub fn flow_left(self) -> ListSelect<M, Left, S>

Flows items from right to left.

pub fn flow_up(self) -> ListSelect<M, Up, S>

Flows items from bottom to top.

pub fn item_size(self, length: f64) -> ListSelect<M, D, Fixed>

Specify a fixed item size, where size is a Scalar in the direction that the List is flowing. When a List is constructed with this method, all items will have a fixed, equal length.

impl<M> ListSelect<M, Down, Dynamic>

pub fn new(num_items: usize, mode: M) -> ListSelect<M, Down, Dynamic> where
    M: Mode, 

Begin building a new ListSelect with the given mode.

This method is only useful when using a custom Mode, otherwise ListSelect::single or ListSelect::multiple will probably be more suitable.

impl<M, D, S> ListSelect<M, D, S>

pub fn scrollbar_next_to(self) -> ListSelect<M, D, S>

Specifies that the List should be scrollable and should provide a Scrollbar to the right of the items.

pub fn scrollbar_on_top(self) -> ListSelect<M, D, S>

Specifies that the List should be scrollable and should provide a Scrollbar that hovers above the right edge of the items and automatically hides when the user is not scrolling.

pub fn scrollbar_thickness(self, w: f64) -> ListSelect<M, D, S>

The width of the Scrollbar.

pub fn scrollbar_color(self, color: Color) -> ListSelect<M, D, S>

The color of the Scrollbar.

impl<M, D> ListSelect<M, D, Fixed>

pub fn instantiate_all_items(self) -> ListSelect<M, D, Fixed>

Indicates that an Item should be instatiated for every element in the list, regardless of whether or not the Item would be visible.

This is the default (and only) behaviour for Lists with dynamic item sizes. This is because a List cannot know the total length of its combined items in advanced when each item is dynamically sized and their size is not given until they are set.

Note: This may cause significantly heavier CPU load for lists containing many items (100+). We only recommend using this when absolutely necessary as large lists may cause unnecessary bloating within the widget graph, and in turn result in greater traversal times.

pub fn instantiate_only_visible_items(self) -> ListSelect<M, D, Fixed>

Indicates that only Items that are visible should be instantiated. This ensures that we avoid bloating the widget graph with unnecessary nodes and in turn keep traversal times to a minimum.

This is the default behaviour for ListSelects with fixed item sizes.

Trait Implementations

impl<M, D, S> Clone for ListSelect<M, D, S> where
    M: Clone,
    S: Clone,
    D: Clone, 

pub fn clone(&self) -> ListSelect<M, D, S>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<M, D, S> Common for ListSelect<M, D, S>

pub fn common(&self) -> &CommonBuilder

Borrows the CommonBuilder field.

pub fn common_mut(&mut self) -> &mut CommonBuilder

Mutably borrows the CommonBuilder field.

impl<M, D, S> Widget for ListSelect<M, D, S> where
    M: Mode,
    S: ItemSize,
    D: Direction, 

type State = State

State to be stored within the Uis widget cache.

type Style = Style

Every widget is required to have its own associated Style type. This type is intended to contain high-level styling information for the widget that can be optionally specified by a user of the widget.

type Event = (Events<M, D, S>, Option<Scrollbar<<D as Direction>::Axis>>)

The type of event yielded by the widget, returned via the Widget::set function.

pub fn init_state(
    &self,
    id_gen: Generator<'_>
) -> <ListSelect<M, D, S> as Widget>::State

Return the initial State of the Widget.

pub fn style(&self) -> <ListSelect<M, D, S> as Widget>::Style

Return the styling of the widget.

pub fn update(
    self,
    args: UpdateArgs<'_, '_, '_, '_, ListSelect<M, D, S>>
) -> <ListSelect<M, D, S> as Widget>::Event

Update the state of the ListSelect.

pub fn default_x_position(&self, ui: &Ui) -> Position

The default Position for the widget along the x axis.

pub fn default_y_position(&self, ui: &Ui) -> Position

The default Position for the widget along the y axis.

pub fn default_x_dimension(&self, ui: &Ui) -> Dimension

The default width for the Widget.

pub fn default_y_dimension(&self, ui: &Ui) -> Dimension

The default height of the widget.

pub fn drag_area(
    &self,
    _dim: [f64; 2],
    _style: &Self::Style,
    _theme: &Theme
) -> Option<Rect>

If the widget is draggable, implement this method and return the position and dimensions of the draggable space. The position should be relative to the center of the widget.

pub fn kid_area(&self, args: KidAreaArgs<'_, Self>) -> KidArea

The area on which child widgets will be placed when using the Place Position methods.

pub fn is_over(&self) -> fn(&Container, [f64; 2], &Theme) -> IsOver

Returns either of the following:

pub fn parent(self, parent_id: NodeIndex<u32>) -> Self

Set the parent widget for this Widget by passing the WidgetId of the parent.

pub fn no_parent(self) -> Self

Specify that this widget has no parent widgets.

pub fn place_on_kid_area(self, b: bool) -> Self

Set whether or not the Widget should be placed on the kid_area.

pub fn graphics_for(self, id: NodeIndex<u32>) -> Self

Indicates that the Widget is used as a non-interactive graphical element for some other widget.

pub fn floating(self, is_floating: bool) -> Self

Set whether or not the widget is floating (the default is false). A typical example of a floating widget would be a pop-up or alert window.

pub fn crop_kids(self) -> Self

Indicates that all widgets who are children of this widget should be cropped to the kid_area of this widget.

pub fn scroll_kids(self) -> Self

Makes the widget’s KidArea scrollable.

pub fn scroll_kids_vertically(self) -> Self

Makes the widget’s KidArea scrollable.

pub fn scroll_kids_horizontally(self) -> Self

Set whether or not the widget’s KidArea is scrollable (the default is false).

pub fn and<F>(self, build: F) -> Self where
    F: FnOnce(Self) -> Self, 

A builder method that “lifts” the Widget through the given build function.

pub fn and_mut<F>(self, mutate: F) -> Self where
    F: FnOnce(&mut Self), 

A builder method that mutates the Widget with the given mutate function.

pub fn and_if<F>(self, cond: bool, build: F) -> Self where
    F: FnOnce(Self) -> Self, 

A method that conditionally builds the Widget with the given build function.

pub fn and_then<T, F>(self, maybe: Option<T>, build: F) -> Self where
    F: FnOnce(Self, T) -> Self, 

A method that optionally builds the Widget with the given build function.

pub fn set(self, id: NodeIndex<u32>, ui_cell: &'a mut UiCell<'b>) -> Self::Event

Note: There should be no need to override this method.