Struct ComboboxState 

pub struct ComboboxState {
    pub area: Rect,
    pub choice: ChoiceState<String>,
    pub text: TextInputState,
    pub focus: FocusFlag,
    pub mouse: MouseFlags,
    pub non_exhaustive: NonExhaustive,
}

Fields

area: Rect

Total area. read only. renewed with each render.

choice: ChoiceState<String>

Core

text: TextInputState

Text

focus: FocusFlag

Focus flag. read+write

mouse: MouseFlags

Mouse util.

non_exhaustive: NonExhaustive

Implementations

impl ComboboxState

pub fn new() -> Self

pub fn named(name: &str) -> Self

pub fn is_popup_active(&self) -> bool

Popup is active?

pub fn flip_popup_active(&mut self)

Flip the popup state.

pub fn set_popup_active(&mut self, active: bool) -> bool

Show the popup.

pub fn set_default_value(&mut self, default_value: Option<String>)

Set a default-value other than T::default()

The starting value will still be T::default() after this. You must call clear() to use this default.

This default will be overridden by a default set on the widget.

pub fn default_value(&self) -> &Option<String>

A default value.

pub fn set_value(&mut self, value: impl Into<String>) -> bool

Select the given value.

If the value doesn’t exist in the list or the list is empty the value will still be set, but selected will be None. The list will be empty before the first render, but the first thing render will do is set the list of values. This will adjust the selected index if possible. It’s still ok to set a value here that can not be represented. As long as there is no user interaction, the same value will be returned by value().

pub fn value(&self) -> String

Get the selected value.

pub fn clear(&mut self) -> bool

Select the default value or T::default.

pub fn select(&mut self, select: usize) -> bool

Select the value at index. This will set the value to the given index in the value-list. If the index is out of bounds or the value-list is empty it will set selected to None and leave the value as is. The list is empty before the first render so this may not work as expected.

The selected index is a best effort artefact, the main thing is the value itself.

Use of set_value() is preferred.

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

Returns the selected index or None if the value is not in the list or the list is empty.

You can still get the value set with set_value() though.

pub fn is_empty(&self) -> bool

Any items?

pub fn len(&self) -> usize

Number of items.

pub fn clear_offset(&mut self)

Scroll offset for the item list.

pub fn set_offset(&mut self, offset: usize) -> bool

Scroll offset for the item list.

pub fn offset(&self) -> usize

Scroll offset for the item list.

pub fn max_offset(&self) -> usize

Scroll offset for the item list.

pub fn page_len(&self) -> usize

Page length for the item list.

pub fn scroll_by(&self) -> usize

Scroll unit for the item list.

pub fn scroll_to_selected(&mut self) -> bool

Scroll the item list to the selected value.

impl ComboboxState

pub fn select_by_char(&mut self, c: char) -> bool

Select by first character.

pub fn reverse_select_by_char(&mut self, c: char) -> bool

Select by first character. Reverse direction

pub fn move_to(&mut self, n: usize) -> ComboboxOutcome

Select at position

pub fn move_down(&mut self, n: usize) -> ComboboxOutcome

Select next entry.

pub fn move_up(&mut self, n: usize) -> ComboboxOutcome

Select prev entry.

Trait Implementations

impl Clone for ComboboxState

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ComboboxState

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

Formats the value using the given formatter.

impl Default for ComboboxState

fn default() -> Self

Returns the “default value” for a type.

impl HandleEvent<Event, MouseOnly, ComboboxOutcome> for ComboboxState

fn handle(&mut self, event: &Event, _qualifier: MouseOnly) -> ComboboxOutcome

Handle an event.

impl HandleEvent<Event, Popup, ComboboxOutcome> for ComboboxState

fn handle(&mut self, event: &Event, _qualifier: Popup) -> ComboboxOutcome

Handle an event.

impl HasFocus for ComboboxState

fn build(&self, builder: &mut FocusBuilder)

Build the focus-structure for the container.

fn focus(&self) -> FocusFlag

Access to the flag for the rest.

fn area(&self) -> Rect

Area for mouse focus.

fn id(&self) -> usize

Provide a unique id for the widget.

fn area_z(&self) -> u16

Z value for the area.

fn navigable(&self) -> Navigation

Declares how the widget interacts with focus.

fn is_focused(&self) -> bool

Focused?

fn lost_focus(&self) -> bool

Just lost focus.

fn gained_focus(&self) -> bool

Just gained focus.

impl HasScreenCursor for ComboboxState

fn screen_cursor(&self) -> Option<(u16, u16)>

This returns the cursor position if

impl RelocatableState for ComboboxState

fn relocate(&mut self, shift: (i16, i16), clip: Rect)

Relocate the areas in this widgets state.

fn relocate_hidden(&mut self)

Relocate all areas to a clip-rect (0,0+0x0).