Struct ExternalDropData 

pub struct ExternalDropData {
    pub files: Vec<PathBuf>,
    pub text: Option<String>,
    pub uris: Vec<String>,
    pub mime: HashMap<String, Vec<u8>>,
    pub formats: Vec<String>,
}

Data delivered by an external (OS) drag-and-drop.

Platform backends populate the fields they can extract from the native drag payload. files are real filesystem paths, text is plain UTF-8 text, uris are non-file:// URLs (e.g. https://…). mime holds any additional raw representations keyed by MIME type, for consumers that want the bytes verbatim.

Fields

files: Vec<PathBuf>

Dropped filesystem paths.

text: Option<String>

Dropped plain text, if any.

uris: Vec<String>

Dropped non-file URLs (http, https, mailto, …).

mime: HashMap<String, Vec<u8>>

Additional raw MIME representations, keyed by MIME type.

formats: Vec<String>

Advertised data formats (platform MIME types / type identifiers), available at drag-enter time even before the bytes are transferred. On Wayland the actual files / text / uris are only filled at drop (received over a pipe), so a drop target validates on hover from these format strings (e.g. "text/uri-list" ⇒ a file drag). macOS / Windows read the full payload at enter, so they fill the data directly and may leave this empty.

Implementations

impl ExternalDropData

pub fn from_uri_list(list: &str) -> Self

Build from a text/uri-list payload (RFC 2483): one URI per line, #-prefixed comment lines ignored, CRLF line endings, percent-encoded. file:// URIs become Self::files; everything else becomes Self::uris. The raw list is also retained under the text/uri-list MIME key.

pub fn is_empty(&self) -> bool

True when there is nothing usable in this payload.

Trait Implementations

impl Clone for ExternalDropData

fn clone(&self) -> ExternalDropData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExternalDropData

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

Formats the value using the given formatter.

impl Default for ExternalDropData

fn default() -> ExternalDropData

Returns the “default value” for a type.