Enum FileDropPhase 

pub enum FileDropPhase {
    Hover,
    Drop,
    Cancel,
    Ended,
}

The file-drop vocabulary for handling file drops from the OS. InputEvent::FileDrop carries a FileDropEvent, which embeds a FileDropPhase (Hover, Drop, Cancel, or the broadcast-only Ended that follows every Drop/Cancel) and the dropped file paths (only on Drop). A widget handling drops is hit-tested and bubbles like [InputEvent::Scroll]. Lifted flat for the same reason EditCommand is: an app’s file-drop handler names these types in its public API without being a widget author. The phase of a desktop OS file drag entering, hovering over, dropping on, or leaving the window — see InputEvent::FileDrop.

A shell publishes only the first three. Ended is the root’s own broadcast follow-up to every Drop/Cancel, handled or not — see FileDropEvent’s Broadcast follow-up section.

Variants

Hover

The drag is hovering the window — it just entered, or moved while still over it. Carries no paths; see FileDropEvent::paths.

Drop

The files were released over the window. Carries every dropped path.

Cancel

The drag left the window, or the OS otherwise called it off, without a drop. Carries no paths.

Ended

Broadcast-only, never sent by a shell: the OS drag is over — a Drop or Cancel was just dispatched hit-tested, whether or not a widget handled it — so crate::app::RenderRoot::event re-dispatches this phase to every widget. Carries no paths and no meaningful position (Point::ZERO, never translated). A widget holding state the drag opened (a drop target’s external drag session) ends whatever of it is still open here, so a release over a region nothing handles — or over a widget other than the one whose state the drag opened — still ends the drag everywhere.

Trait Implementations

impl Clone for FileDropPhase

fn clone(&self) -> FileDropPhase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for FileDropPhase

impl Debug for FileDropPhase

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

Formats the value using the given formatter.

impl Eq for FileDropPhase

impl PartialEq for FileDropPhase

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FileDropPhase