Struct DragPayload 

pub struct DragPayload {
    pub drag_type: String,
    pub data: Vec<u8>,
    pub display_text: Option<String>,
}

Data carried during a drag operation.

The payload uses a MIME-like type string for matching against drop targets and raw bytes for the actual data. This decouples the drag source from the drop target — they only need to agree on the type string and byte format.

Examples

let payload = DragPayload::text("hello world");
assert_eq!(payload.drag_type, "text/plain");
assert_eq!(payload.display_text.as_deref(), Some("hello world"));

Fields

drag_type: String

MIME-like type identifier (e.g., "text/plain", "widget/list-item").

data: Vec<u8>

Raw serialized data.

display_text: Option<String>

Human-readable preview text shown during drag (optional).

Implementations

impl DragPayload

pub fn new(drag_type: impl Into<String>, data: Vec<u8>) -> Self

Create a payload with raw bytes.

pub fn text(text: impl Into<String>) -> Self

Create a plain-text payload.

pub fn with_display_text(self, text: impl Into<String>) -> Self

Create a payload with custom display text.

pub fn as_text(&self) -> Option<&str>

Attempt to decode the data as a UTF-8 string.

pub fn data_len(&self) -> usize

Returns the byte length of the payload data.

pub fn matches_type(&self, pattern: &str) -> bool

Returns true if the payload type matches the given pattern.

Supports exact match and wildcard prefix (e.g., "text/*").

Trait Implementations

impl Clone for DragPayload

fn clone(&self) -> DragPayload

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DragPayload

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

Formats the value using the given formatter.