Struct FileDialog

pub struct FileDialog { /* private fields */ }

A file dialog control

The file dialog builders accepts the following parameters:

• title: The title of the dialog
• action: The action to execute. Open, OpenDirectory for Save
• multiselect: Whether the user can select more than one file. Only supported with the Open action
• default_folder: Default folder to show in the dialog.
• filters: If defined, filter the files that the user can select (In a Open dialog) or which extension to add to the saved file (in a Save dialog) The filters value must be a ‘|’ separated string having this format: “Test(.txt;.rs)|Any(.)”

    use native_windows_gui as nwg;
    fn layout(dialog: &mut nwg::FileDialog) {
        nwg::FileDialog::builder()
            .title("Hello")
            .action(nwg::FileDialogAction::Open)
            .multiselect(true)
            .build(dialog);
    }

Implementations

impl FileDialog

pub fn builder() -> FileDialogBuilder

pub fn action(&self) -> FileDialogAction

Return the action type executed by this dialog

pub fn run<C: Into<ControlHandle>>(&self, parent: Option<C>) -> bool

Display the dialog. Return true if the dialog was accepted or false if it was cancelled If the dialog was accepted, get_selected_item or get_selected_items can be used to find the selected file(s)

It’s important to note that run blocks the current thread until the user as chosen a file (similar to dispatch_thread_events)

The parent argument must be a window control otherwise the method will panic.

pub fn get_selected_item(&self) -> Result<OsString, NwgError>

Return the item selected in the dialog by the user.

Failures:
• if the dialog was not called
• if there was a system error while reading the selected item
• if the dialog has the multiselect flag

pub fn get_selected_items(&self) -> Result<Vec<OsString>, NwgError>

Return the selected items in the dialog by the user. Failures:
• if the dialog was not called
• if there was a system error while reading the selected items
• if the dialog has Save for action

pub fn multiselect(&self) -> bool

Return true if the dialog accepts multiple values or false otherwise

pub fn set_multiselect(&self, multiselect: bool) -> Result<(), NwgError>

Set the multiselect flag of the dialog. Failures:
• if there was a system error while setting the new flag value
• if the dialog has Save for action

pub fn set_default_folder<'a>(&self, folder: &'a str) -> Result<(), NwgError>

Set the first opened folder when the dialog is shown. This value is overriden by the user after the dialog ran.
Call clear_client_data to fix that. Failures: • if the default folder do not identify a folder
• if the folder do not exists

pub fn set_filters<'a>(&self, filters: &'a str) -> Result<(), NwgError>

Filter the files that the user can select (In a Open dialog) in the dialog or which extension to add to the saved file (in a Save dialog).
This can only be set ONCE (the initialization counts) and won’t work if the dialog is OpenDirectory.

The filters value must be a ‘|’ separated string having this format: “Test(.txt;.rs)|Any(.)”
Where the fist part is the “human name” and the second part is a filter for the system.

pub fn set_title<'a>(&self, title: &'a str)

Change the dialog title

pub fn clear_client_data(&self)

Instructs the dialog to clear all persisted state information (such as the last folder visited).

Trait Implementations

impl Debug for FileDialog

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

Formats the value using the given formatter.

impl Default for FileDialog

fn default() -> FileDialog

Returns the “default value” for a type.

impl PartialEq for FileDialog

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FileDialog