Struct SuggestionTextInput 

pub struct SuggestionTextInput<'a, T, Message, Theme = Theme, Renderer = Renderer>
where
    Theme: Catalog,
    Renderer: Renderer,
{

    state: &'a State<T>,
    text_input: TextInput<'a, TextInputEvent, Theme, Renderer>,
    font: Option<Renderer::Font>,
    selection: Value,
    on_selected: Box<dyn Fn(T) -> Message>,
    on_option_hovered: Option<Box<dyn Fn(T) -> Message>>,
    on_open: Option<Message>,
    on_close: Option<Message>,
    on_input: Option<Box<dyn Fn(String) -> Message>>,
    padding: Padding,
    size: Option<f32>,
    text_shaping: Shaping,
    menu_class: <Theme as Catalog>::Class<'a>,
    menu_height: Length,
}

A widget for searching and selecting a single value from a list of options.

Example

use iced::widget::combo_box;

struct State {
   fruits: combo_box::State<Fruit>,
   favorite: Option<Fruit>,
}

#[derive(Debug, Clone)]
enum Fruit {
    Apple,
    Orange,
    Strawberry,
    Tomato,
}

#[derive(Debug, Clone)]
enum Message {
    FruitSelected(Fruit),
}

fn view(state: &State) -> Element<'_, Message> {
    combo_box(
        &state.fruits,
        "Select your favorite fruit...",
        state.favorite.as_ref(),
        Message::FruitSelected
    )
    .into()
}

fn update(state: &mut State, message: Message) {
    match message {
        Message::FruitSelected(fruit) => {
            state.favorite = Some(fruit);
        }
    }
}

impl std::fmt::Display for Fruit {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(match self {
            Self::Apple => "Apple",
            Self::Orange => "Orange",
            Self::Strawberry => "Strawberry",
            Self::Tomato => "Tomato",
        })
    }
}

Fields

state: &'a State<T>

text_input: TextInput<'a, TextInputEvent, Theme, Renderer>

font: Option<Renderer::Font>

selection: Value

on_selected: Box<dyn Fn(T) -> Message>

on_option_hovered: Option<Box<dyn Fn(T) -> Message>>

on_open: Option<Message>

on_close: Option<Message>

on_input: Option<Box<dyn Fn(String) -> Message>>

padding: Padding

size: Option<f32>

text_shaping: Shaping

menu_class: <Theme as Catalog>::Class<'a>

menu_height: Length

Implementations

impl<'a, T, Message, Theme, Renderer> SuggestionTextInput<'a, T, Message, Theme, Renderer>

where T: Display + Clone, Theme: Catalog, Renderer: Renderer,

pub fn new( state: &'a State<T>, placeholder: &str, selection: Option<&T>, on_selected: impl Fn(T) -> Message + 'static, ) -> Self

Creates a new SuggestionTextInput with the given list of options, a placeholder, the current selected value, and the message to produce when an option is selected.

pub fn on_input(self, on_input: impl Fn(String) -> Message + 'static) -> Self

Sets the message that should be produced when some text is typed into the TextInput of the SuggestionTextInput.

pub fn on_option_hovered( self, on_option_hovered: impl Fn(T) -> Message + 'static, ) -> Self

Sets the message that will be produced when an option of the SuggestionTextInput is hovered using the arrow keys.

pub fn on_open(self, message: Message) -> Self

Sets the message that will be produced when the SuggestionTextInput is opened.

pub fn on_close(self, message: Message) -> Self

Sets the message that will be produced when the outside area of the SuggestionTextInput is pressed.

pub fn padding(self, padding: impl Into<Padding>) -> Self

Sets the Padding of the SuggestionTextInput.

pub fn font(self, font: Renderer::Font) -> Self

Sets the Renderer::Font of the SuggestionTextInput.

pub fn icon(self, icon: Icon<Renderer::Font>) -> Self

Sets the text_input::Icon of the SuggestionTextInput.

pub fn size(self, size: impl Into<Pixels>) -> Self

Sets the text size of the SuggestionTextInput.

pub fn line_height(self, line_height: impl Into<LineHeight>) -> Self

Sets the LineHeight of the SuggestionTextInput.

pub fn width(self, width: impl Into<Length>) -> Self

Sets the width of the SuggestionTextInput.

pub fn menu_height(self, menu_height: impl Into<Length>) -> Self

Sets the height of the menu of the SuggestionTextInput.

pub fn text_shaping(self, shaping: Shaping) -> Self

Sets the text::Shaping strategy of the SuggestionTextInput.

pub fn input_style(self, style: impl Fn(&Theme, Status) -> Style + 'a) -> Self

where <Theme as Catalog>::Class<'a>: From<StyleFn<'a, Theme>>,

Sets the style of the input of the SuggestionTextInput.

pub fn menu_style(self, style: impl Fn(&Theme) -> Style + 'a) -> Self

where <Theme as Catalog>::Class<'a>: From<StyleFn<'a, Theme>>,

Sets the style of the menu of the SuggestionTextInput.

pub fn input_class( self, class: impl Into<<Theme as Catalog>::Class<'a>>, ) -> Self

Sets the style class of the input of the SuggestionTextInput.

pub fn menu_class(self, class: impl Into<<Theme as Catalog>::Class<'a>>) -> Self

Sets the style class of the menu of the SuggestionTextInput.

Trait Implementations

impl<'a, T, Message, Theme, Renderer> From<SuggestionTextInput<'a, T, Message, Theme, Renderer>> for Element<'a, Message, Theme, Renderer>

where T: Display + Clone + 'static, Message: Clone + 'a, Theme: Catalog + 'a, Renderer: Renderer + 'a,

fn from( suggestion_text_input: SuggestionTextInput<'a, T, Message, Theme, Renderer>, ) -> Self

Converts to this type from the input type.

impl<T, Message, Theme, Renderer> Widget<Message, Theme, Renderer> for SuggestionTextInput<'_, T, Message, Theme, Renderer>

where T: Display + Clone + 'static, Message: Clone, Theme: Catalog, Renderer: Renderer,

fn size(&self) -> Size<Length>

Returns the Size of the Widget in lengths.

fn layout( &mut self, tree: &mut Tree, renderer: &Renderer, limits: &Limits, ) -> Node

Returns the layout::Node of the Widget.

fn draw( &self, tree: &Tree, renderer: &mut Renderer, theme: &Theme, _style: &Style, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, )

Draws the Widget using the associated Renderer.

fn tag(&self) -> Tag

Returns the Tag of the Widget.

fn state(&self) -> State

Returns the State of the Widget.

fn children(&self) -> Vec<Tree>

Returns the state Tree of the children of the Widget.

fn diff(&self, _tree: &mut Tree)

Reconciles the Widget with the provided Tree.

fn update( &mut self, tree: &mut Tree, event: &Event, layout: Layout<'_>, cursor: Cursor, renderer: &Renderer, clipboard: &mut dyn Clipboard, shell: &mut Shell<'_, Message>, viewport: &Rectangle, )

Processes a runtime Event.

fn mouse_interaction( &self, tree: &Tree, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, renderer: &Renderer, ) -> Interaction

Returns the current mouse::Interaction of the Widget.

fn overlay<'b>( &'b mut self, tree: &'b mut Tree, layout: Layout<'_>, _renderer: &Renderer, viewport: &Rectangle, translation: Vector, ) -> Option<Element<'b, Message, Theme, Renderer>>

Returns the overlay of the Widget, if there is any.

fn size_hint(&self) -> Size<Length>

Returns a Size hint for laying out the Widget.

fn operate( &mut self, _tree: &mut Tree, _layout: Layout<'_>, _renderer: &Renderer, _operation: &mut dyn Operation, )

Applies an Operation to the Widget.