Struct SimpleComboBox 

pub struct SimpleComboBox<E: ToString> {
    pub variants: Vec<E>,
    pub active_index: Option<usize>,
}

A simple wrapper around gtk::ComboBox.

This can be used with enums, Strings or any custom type you want. The only requirement is that the inner type implements ToString and Debug.

To get notified when the selection changed, you can use Connector::forward() after launching the component.

Fields

variants: Vec<E>

The variants that can be selected.

active_index: Option<usize>

The index of the active element or None is nothing is selected.

Implementations

impl<E> SimpleComboBox<E>

where E: ToString,

pub fn get_active_elem(&self) -> Option<&E>

Return the value of the currently selected element or None if nothing is selected.

Examples found in repository

relm4-components/examples/combo_box.rs (line 29)

    fn lang(&self) -> &str {
        // you can also use self.combo.model().variants[self.idx]
        self.combo
            .model()
            .get_active_elem()
            .expect("combo box should have an active element")
    }

Trait Implementations

impl<E: Clone + ToString> Clone for SimpleComboBox<E>

fn clone(&self) -> SimpleComboBox<E>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E> Component for SimpleComboBox<E>

where E: ToString + 'static + Debug,

type CommandOutput = ()

Messages which are received from commands executing in the background.

type Input = SimpleComboBoxMsg<E>

The message type that the component accepts as inputs.

type Output = usize

The message type that the component provides as outputs.

type Init = SimpleComboBox<E>

The parameter used to initialize the component.

type Root = ComboBoxText

The top-level widget of the component.

type Widgets = ComboBoxText

The type that’s used for storing widgets created for this component.

fn init_root() -> Self::Root

Initializes the root widget.

fn init( model: Self::Init, widgets: Self::Root, sender: ComponentSender<Self>, ) -> ComponentParts<Self>

Creates the initial model and view, docking it into the component.

fn update_with_view( &mut self, widgets: &mut Self::Widgets, input: Self::Input, sender: ComponentSender<Self>, _root: &Self::Root, )

Updates the model and view when a new input is received.

fn builder() -> ComponentBuilder<Self>

Create a builder for this component.

fn update( &mut self, message: Self::Input, sender: ComponentSender<Self>, root: &Self::Root, )

Processes inputs received by the component.

fn update_cmd( &mut self, message: Self::CommandOutput, sender: ComponentSender<Self>, root: &Self::Root, )

Defines how the component should respond to command updates.

fn update_cmd_with_view( &mut self, widgets: &mut Self::Widgets, message: Self::CommandOutput, sender: ComponentSender<Self>, root: &Self::Root, )

Updates the model and view upon completion of a command.

fn update_view( &self, widgets: &mut Self::Widgets, sender: ComponentSender<Self>, )

Updates the view after the model has been updated.

fn shutdown( &mut self, widgets: &mut Self::Widgets, output: Sender<Self::Output>, )

Last method called before a component is shut down.

fn id(&self) -> String

An identifier for the component used for debug logging.

impl<E: Debug + ToString> Debug for SimpleComboBox<E>

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

Formats the value using the given formatter.

impl<E: PartialEq + ToString> PartialEq for SimpleComboBox<E>

fn eq(&self, other: &SimpleComboBox<E>) -> 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.

impl<E: Eq + ToString> Eq for SimpleComboBox<E>

impl<E: ToString> StructuralPartialEq for SimpleComboBox<E>