Struct FileDialogBuilder

pub struct FileDialogBuilder {
    pub filename: Option<String>,
    pub location: Option<PathBuf>,
    pub filters: FileFiltersBag,
    pub owner: UnsafeWindowHandle,
    pub title: Option<String>,
}

Builder for file dialogs.

Fields

filename: Option<String>

location: Option<PathBuf>

filters: FileFiltersBag

owner: UnsafeWindowHandle

title: Option<String>

Implementations

impl FileDialogBuilder

pub fn set_title(self, title: impl ToString) -> Self

Sets the window title for the dialog.

pub fn set_filename(self, filename: impl ToString) -> Self

Sets the default value of the filename text field in the dialog. For open dialogs of macOS and zenity, this is a no-op because there’s no such text field on the dialog.

pub fn reset_filename(self) -> Self

Resets the default value of the filename field in the dialog.

pub fn set_location<P: AsRef<Path> + ?Sized>(self, path: &P) -> Self

Sets the default directory that the dialog shows at open.

pub fn reset_location(self) -> Self

Resets the default directory that the dialog shows at open. If a location is not set, the dialog will probably go to the current working directory.

pub fn add_filter<T, U, V>(self, name: T, extensions: V) -> Self

where T: ToString, U: ToString, V: AsRef<[U]>,

Adds a file type filter. The filter must contains at least one extension, otherwise this method will be a no-op. For dialogs that open directories, this is also a no-op.

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

where I: IntoIterator<Item = (String, Vec<String>)>,

Adds a bunch of file type filters.

pub fn reset_filters(self) -> Self

Removes all file type filters.

pub fn set_owner<W: HasWindowHandle>(self, window: &W) -> Self

Sets the owner of the dialog.

pub fn reset_owner(self) -> Self

Resets the owner of the dialog to nothing.

pub fn open_single_file(self) -> OpenSingleFile

Builds a dialog that let users to open one file.

pub fn open_multiple_file(self) -> OpenMultipleFile

Builds a dialog that let users to open multiple files.

pub fn open_single_dir(self) -> OpenSingleDir

Builds a dialog that let users to open one directory.

pub fn save_single_file(self) -> SaveSingleFile

Builds a dialog that let users to save one file.

Trait Implementations

impl Clone for FileDialogBuilder

fn clone(&self) -> FileDialogBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileDialogBuilder

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

Formats the value using the given formatter.

impl Default for FileDialogBuilder

fn default() -> FileDialogBuilder

Returns the “default value” for a type.