Struct native_windows_gui::FileDialog
source · [−]pub struct FileDialog { /* private fields */ }
Expand description
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
sourceimpl FileDialog
impl FileDialog
pub fn builder() -> FileDialogBuilder
sourcepub fn action(&self) -> FileDialogAction
pub fn action(&self) -> FileDialogAction
Return the action type executed by this dialog
sourcepub fn run<C: Into<ControlHandle>>(&self, parent: Option<C>) -> bool
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.
sourcepub fn get_selected_item(&self) -> Result<OsString, NwgError>
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
sourcepub fn get_selected_items(&self) -> Result<Vec<OsString>, NwgError>
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
sourcepub fn multiselect(&self) -> bool
pub fn multiselect(&self) -> bool
Return true
if the dialog accepts multiple values or false
otherwise
sourcepub fn set_multiselect(&self, multiselect: bool) -> Result<(), NwgError>
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
sourcepub fn set_default_folder<'a>(&self, folder: &'a str) -> Result<(), NwgError>
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
sourcepub fn set_filters<'a>(&self, filters: &'a str) -> Result<(), NwgError>
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.
sourcepub fn clear_client_data(&self)
pub fn clear_client_data(&self)
Instructs the dialog to clear all persisted state information (such as the last folder visited).
Trait Implementations
sourceimpl Debug for FileDialog
impl Debug for FileDialog
sourceimpl Default for FileDialog
impl Default for FileDialog
sourcefn default() -> FileDialog
fn default() -> FileDialog
Returns the “default value” for a type. Read more
sourceimpl PartialEq<FileDialog> for FileDialog
impl PartialEq<FileDialog> for FileDialog
impl Eq for FileDialog
Auto Trait Implementations
impl RefUnwindSafe for FileDialog
impl !Send for FileDialog
impl !Sync for FileDialog
impl Unpin for FileDialog
impl UnwindSafe for FileDialog
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more