Enum ExternalDragEvent 

pub enum ExternalDragEvent {
    Entered {
        data: ExternalDropData,
        position: Point,
    },
    Moved {
        position: Point,
    },
    Left,
    Cancelled,
    Dropped {
        data: ExternalDropData,
        position: Point,
    },
    DragEnded {
        outcome: DropOutcome,
    },
}

One phase of an external (OS) drag over a window. Positions are in the window’s logical coordinate space (top-left origin), already converted from the platform’s native coordinates.

Variants

Entered

The drag entered the window. data is the best-effort payload the source offers (fully populated where the platform exposes it during hover — e.g. macOS; possibly empty until drop on backends that only transfer bytes at drop time). Lets a drop target validate on hover.

Fields

data: ExternalDropData

Offered payload (files / text / URLs); may be empty until drop.

position: Point

Entry position in window-logical coordinates.

Moved

The pointer moved while the drag is over the window.

Fields

position: Point

Current position in window-logical coordinates.

Left

The drag left the window without a drop, and may come back.

For an app-originated drag currently re-entered into this window this is not the end: the OS drag is still in flight, so the framework parks the typed payload for whichever window the drag enters next. Use Cancelled for an ending.

Cancelled

The drag over this window has been aborted: no drop will follow, and nothing is coming back.

Distinct from Left in exactly one way, and it is the reason both exist: a leave re-parks a re-entered app drag’s typed payload because the OS drag continues, while an abort must not — a parked payload belonging to a drag that has ended could be misclaimed by the next genuine drag from another application.

Which backends produce it. No OS tells a destination that a foreign drag was aborted rather than merely leaving: wl_data_device sends leave, XDND sends XdndLeave, OLE calls DragLeave, and AppKit calls draggingExited:, in both cases. What a backend does know is that its own outbound drag has ended while it was over one of this app’s windows, and the Wayland and X11 backends report that here.

Dropped

The user dropped. Carries the extracted payload and the drop position.

Fields

data: ExternalDropData

Files / text / URLs / raw MIME bytes extracted from the OS payload.

position: Point

Drop position in window-logical coordinates.

DragEnded

An outbound (app → OS) drag this window started has finished. Posted by the platform backend’s drag-source callback so the framework can notify the source widget’s on_drag_ended.

Fields

outcome: DropOutcome

How the OS drag resolved (copy / move into another app, or cancel).

Trait Implementations

impl Clone for ExternalDragEvent

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExternalDragEvent

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

Formats the value using the given formatter.