Struct DragAndDrop

pub struct DragAndDrop {
    payload: Option<Arc<dyn Any + Send + Sync>>,
}

Tracking of drag-and-drop payload.

This is a low-level API.

For a higher-level API, see:

• crate::Ui::dnd_drag_source
• crate::Ui::dnd_drop_zone
• crate::Response::dnd_set_drag_payload
• crate::Response::dnd_hover_payload
• crate::Response::dnd_release_payload

See this example.

Fields

payload: Option<Arc<dyn Any + Send + Sync>>

If set, something is currently being dragged

Implementations

impl DragAndDrop

pub(crate) fn register(ctx: &Context)

fn begin_pass(ctx: &Context)

Interrupt drag-and-drop if the user presses the escape key.

This needs to happen at frame start so we can properly capture the escape key.

fn end_pass(ctx: &Context)

Interrupt drag-and-drop if the user releases the mouse button.

This is a catch-all safety net in case user code doesn’t capture the drag payload itself. This must happen at end-of-frame such that we don’t shadow the mouse release event from user code.

pub fn set_payload<Payload>(ctx: &Context, payload: Payload)

where Payload: Any + Send + Sync,

Set a drag-and-drop payload.

This can be read by Self::payload until the pointer is released.

pub fn clear_payload(ctx: &Context)

Clears the payload, setting it to None.

pub fn payload<Payload>(ctx: &Context) -> Option<Arc<Payload>>

where Payload: Any + Send + Sync,

Retrieve the payload, if any.

Returns None if there is no payload, or if it is not of the requested type.

Returns Some both during a drag and on the frame the pointer is released (if there is a payload).

pub fn take_payload<Payload>(ctx: &Context) -> Option<Arc<Payload>>

where Payload: Any + Send + Sync,

Retrieve and clear the payload, if any.

Returns None if there is no payload, or if it is not of the requested type.

Returns Some both during a drag and on the frame the pointer is released (if there is a payload).

pub fn has_payload_of_type<Payload>(ctx: &Context) -> bool

where Payload: Any + Send + Sync,

Are we carrying a payload of the given type?

Returns true both during a drag and on the frame the pointer is released (if there is a payload).

pub fn has_any_payload(ctx: &Context) -> bool

Are we carrying a payload?

Returns true both during a drag and on the frame the pointer is released (if there is a payload).

Trait Implementations

impl Clone for DragAndDrop

fn clone(&self) -> DragAndDrop

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for DragAndDrop

fn default() -> DragAndDrop

Returns the “default value” for a type.