Struct FileDropZone 

pub struct FileDropZone { /* private fields */ }

A click-and-drop file target.

let drop = FileDropZone::new().show(ui);
if drop.response.clicked() {
    // Open a native file picker, e.g. via the `rfd` crate.
}
for file in &drop.dropped_files {
    // Handle file.path / file.bytes.
    let _ = file;
}

Implementations

impl FileDropZone

pub fn new() -> Self

Create a drop zone with the default prompt, action word, and minimum height.

pub fn prompt(self, prompt: impl Into<WidgetText>) -> Self

Override the prompt text. Defaults to “Drop files here, or browse”, where the action word is rendered in the sky accent.

pub fn action_word(self, word: impl Into<String>) -> Self

Override the action word rendered in the sky accent inside the prompt. Defaults to "browse". Ignored if Self::prompt is set.

pub fn hint(self, hint: impl Into<WidgetText>) -> Self

Set the hint line under the prompt (e.g. accepted formats and size limits). Defaults to no hint.

pub fn min_height(self, h: f32) -> Self

Override the minimum height of the zone in points. Defaults to 120.

pub fn enabled(self, enabled: bool) -> Self

Disable the zone. Defaults to enabled.

pub fn show(self, ui: &mut Ui) -> FileDropResponse

Render the zone and return the response plus any files dropped on its rect this frame.

Trait Implementations

impl Debug for FileDropZone

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

Formats the value using the given formatter.

impl Default for FileDropZone

fn default() -> Self

Returns the “default value” for a type.