Struct FileDialog 

pub struct FileDialog { /* private fields */ }

Builder for launching file dialogs

Implementations

impl FileDialog

pub fn new(mode: DialogMode) -> Self

Create a new builder with the given mode

pub fn backend(self, backend: Backend) -> Self

Choose a backend (Auto by default)

pub fn directory(self, dir: impl Into<PathBuf>) -> Self

Set initial directory

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

Set default file name (for SaveFile)

pub fn multi_select(self, yes: bool) -> Self

Allow multi selection (only for OpenFiles)

pub fn max_selection(self, max: usize) -> Self

Limit the maximum number of selected files (IGFD countSelectionMax-like).

• 0 means “infinite” (no limit).
• 1 behaves like a single-selection dialog.

Note: native dialogs may not be able to enforce the limit interactively; results are clamped best-effort.

pub fn show_hidden(self, yes: bool) -> Self

Show hidden files in ImGui browser (native follows OS behavior)

pub fn filter<F: Into<FileFilter>>(self, filter: F) -> Self

Add a filter.

Examples

use dear_file_browser::{FileDialog, DialogMode};
let d = FileDialog::new(DialogMode::OpenFile)
    .filter(("Images", &["png", "jpg"][..]))
    .filter(("Rust", &["rs"][..]))
    .show_hidden(true);

pub fn filters<I, F>(self, filters: I) -> Self

where I: IntoIterator<Item = F>, F: Into<FileFilter>,

Add multiple filters.

The list will be appended to any previously-added filters. Extensions are compared case-insensitively and should be provided without dots.

Examples

use dear_file_browser::{FileDialog, DialogMode, FileFilter};
let filters = vec![
    FileFilter::from(("Images", &["png", "jpg", "jpeg"][..]))
];
let d = FileDialog::new(DialogMode::OpenFiles)
    .filters(filters)
    .multi_select(true);

pub fn filters_igfd( self, spec: impl AsRef<str>, ) -> Result<Self, IgfdFilterParseError>

Parse and add one or more IGFD-style filters.

This is a convenience wrapper over FileFilter::parse_igfd.

impl FileDialog

pub fn open_blocking(self) -> Result<Selection, FileDialogError>

Open a dialog synchronously (blocking).

pub async fn open_async(self) -> Result<Selection, FileDialogError>

Open a dialog asynchronously via rfd::AsyncFileDialog.

Trait Implementations

impl Clone for FileDialog

fn clone(&self) -> FileDialog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileDialog

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

Formats the value using the given formatter.