Struct FileDialogRequest 

pub struct FileDialogRequest { /* private fields */ }

Builder describing one file-dialog request.

Construct via Self::pick_file / Self::pick_files / Self::pick_folder / Self::save_file; chain options; hand to FileDialogHandle::submit (or call one of the EventContext::pick_* convenience methods).

Implementations

impl FileDialogRequest

pub fn pick_file() -> Self

Build an open-single-file dialog request.

pub fn pick_files() -> Self

Build an open-multiple-files dialog request.

pub fn pick_folder() -> Self

Build a pick-folder dialog request.

pub fn save_file() -> Self

Build a save-file dialog request.

pub fn title(self, t: impl Into<String>) -> Self

Set the dialog’s title (window caption on most platforms).

pub fn starting_dir(self, p: impl Into<PathBuf>) -> Self

Set the directory the dialog opens in.

pub fn default_file_name(self, n: impl Into<String>) -> Self

Set the default file name pre-filled in the save dialog. No-op for open / pick-folder kinds (kept on the request so callers can prepare a single builder regardless of kind).

pub fn add_filter(self, label: impl Into<String>, extensions: &[&str]) -> Self

Add an extension filter row (e.g. "Images", &["png", "jpg"]). Extensions are case-insensitive on platforms that natively support filtering; do not include leading dots.

pub fn with_parent(self, p: ParentHandle) -> Self

Stamp the parent window handle. Called by the EventContext::pick_* convenience methods — apps that submit a request directly via FileDialogHandle::submit are responsible for providing the parent handle themselves.

pub fn validate(&self) -> Result<(), String>

Validate filter extensions. Called by FileDialogHandle::submit before dispatch. Returns the first problem found:

• empty extensions list on a filter,
• extension containing a leading dot, slash, or whitespace.

Trait Implementations

impl Clone for FileDialogRequest

fn clone(&self) -> FileDialogRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileDialogRequest

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

Formats the value using the given formatter.