Enum Control 

#[non_exhaustive]
pub enum Control<Event> {
    Continue,
    Unchanged,
    Changed,
    Event(Event),
    Close(Event),
    Quit,
}

Result enum for event handling.

The result of an event is processed immediately after the function returns, before polling new events. This way an action can trigger another action which triggers the repaint without other events intervening.

If you ever need to return more than one result from event-handling, you can hand it to AppContext/RenderContext::queue(). Events in the queue are processed in order, and the return value of the event-handler comes last. If an error is returned, everything send to the queue will be executed nonetheless.

See

• flow!
• try_flow!
• ConsumedEvent

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Continue

Continue with event-handling. In the event-loop this waits for the next event.

Unchanged

Break event-handling without repaint. In the event-loop this waits for the next event.

Changed

Break event-handling and repaints/renders the application. In the event-loop this calls render.

Event(Event)

Eventhandling can cause secondary application specific events. One common way is to return this Control::Message(my_event) to reenter the event-loop with your own secondary event.

This acts quite like a message-queue to communicate between disconnected parts of your application. And indeed there is a hidden message-queue as part of the event-loop.

The other way is to call SalsaAppContext::queue to initiate such events.

Close(Event)

A dialog close event. In the main loop it will be handled just like Control::Event. But the DialogStack can react separately and close the window.

Quit

Quit the application.

Trait Implementations

impl<Event: Clone> Clone for Control<Event>

fn clone(&self) -> Control<Event>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Event> ConsumedEvent for Control<Event>

fn is_consumed(&self) -> bool

Is this the ‘consumed’ result.

fn or_else<F>(self, f: F) -> Self

where F: FnOnce() -> Self, Self: Sized,

Or-Else chaining with is_consumed() as the split.

fn or_else_try<F, E>(self, f: F) -> Result<Self, E>

where Self: Sized, F: FnOnce() -> Result<Self, E>,

Or-Else chaining with is_consumed() as the split.

fn and_then<F>(self, f: F) -> Self

where Self: Sized + Ord, F: FnOnce() -> Self,

And_then-chaining based on is_consumed(). Returns max(self, f()).

fn and_then_try<F, E>(self, f: F) -> Result<Self, E>

where Self: Sized + Ord, F: FnOnce() -> Result<Self, E>,

And_then-chaining based on is_consumed(). Returns max(self, f()).

fn and<F>(self, f: F) -> Self

where Self: Sized + Ord, F: FnOnce() -> Self,

👎Deprecated since 1.2.2: use and_then()

Then-chaining. Returns max(self, f()).

fn and_try<F, E>(self, f: F) -> Result<Self, E>

where Self: Sized + Ord, F: FnOnce() -> Result<Self, E>,

👎Deprecated since 1.2.2: use and_then_try()

Then-chaining. Returns max(self, f()).

impl<Event: Debug> Debug for Control<Event>

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

Formats the value using the given formatter.

impl<Event, T: Into<Outcome>> From<T> for Control<Event>

fn from(value: T) -> Self

Converts to this type from the input type.

impl<Event> Ord for Control<Event>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<Event> PartialEq for Control<Event>

fn eq(&self, other: &Self) -> 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<Event> PartialOrd for Control<Event>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<Event: Copy> Copy for Control<Event>

impl<Event> Eq for Control<Event>