Struct Popup 

pub struct Popup;

With the latest enhancement of Focus this is obsolete.

Focus collects all the areas of widgets and containers and can set a z-index for each area. With this information it runs a hit-test for each mouse event and sets and sets the mouse-focus flag for each widget and container. This works well with popups and overlapping widgets. This makes the differentiation between regular widgets and widgets that might show a popup that overlaps other widgets obsolete.

If you don’t use Focus you will still have to consider the information below.

Obsoleted

Popup/Overlays are a bit difficult to handle, as there is no z-order/area tree, which would direct mouse interactions. We can simulate a z-order in the event-handler by trying the things with a higher z-order first.

If a widget might show a popup, you have to call its event-handling before any other widgets that might be (partially) hidden behind the widget. This applies for e.g. Menubar, Choice and ComboBox. To make this difference visible in the application code, these widgets use Popup as marker for their event-handling instead of Regular.

If you implement a widget with a popup, you must make sure to consume all mouse-events within the widget area to prevent any interaction with a hidden widget.

Trait Implementations

impl Clone for Popup

fn clone(&self) -> Popup

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Popup

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

Formats the value using the given formatter.

impl Default for Popup

fn default() -> Popup

Returns the “default value” for a type.

impl<T: PartialEq + Clone + Default> HandleEvent<Event, Popup, ChoiceOutcome> for ChoiceState<T>

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

Handle an event.

impl HandleEvent<Event, Popup, ComboboxOutcome> for ComboboxState

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

Handle an event.

impl HandleEvent<Event, Popup, MenuOutcome> for MenubarState

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

Handle an event.

impl HandleEvent<Event, Popup, MenuOutcome> for PopupMenuState

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

Handle all events.

Key-events are only handled when the popup menu is_active. You need to set this state according to your logic.

The popup menu will return MenuOutcome::Hide if it thinks it should be hidden.

impl HandleEvent<Event, Popup, PopupOutcome> for PopupCoreState

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

Handle an event.

impl Copy for Popup