Enum Modality 

pub enum Modality {
    Owned,
    Modal,
    Independent,
}

How a secondary window relates to the one that opened it.

How much of this the platform will actually enforce differs sharply: Windows does all of it, macOS keeps the z-order and blocks nothing, and X11 and Wayland offer neither through winit. So the one guarantee that holds everywhere is Modal input blocking, because the runner does that itself rather than asking. The rest is appearance, and the crate’s README has the table.

Variants

Owned

Above its owner, closed with it, and input still reaches both.

The default, and what a settings form or an “edit details” window wants: a window belonging to this application rather than a second application that happens to share a process. The user can keep working in the main window while it is open.

Modal

Owned, and the owner takes no input until this window closes.

The window-sized version of Ui::push_scene with a dim: a confirmation, a wizard, anything the user must answer before going back. The owner keeps drawing — animations there do not freeze — it simply stops listening, and a press on it raises this window instead.

Independent

A window of its own, with no relationship to its opener at all.

A second document window, or a tool palette the user may want behind the main window. It does not close when its opener does, so an application that opens one is responsible for it — including for the fact that closing the main window ends the run and takes it down regardless.

Trait Implementations

impl Clone for Modality

fn clone(&self) -> Modality

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Modality

impl Debug for Modality

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

Formats the value using the given formatter.

impl Default for Modality

fn default() -> Modality

Returns the “default value” for a type.

impl Eq for Modality

impl Hash for Modality

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Modality

fn eq(&self, other: &Modality) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Modality