Struct e_utils::dialog::blocking::FileBuilder

pub struct FileBuilder(/* private fields */);

The file dialog builder.

Constructs file picker dialogs that can select single/multiple files or directories.

Implementations

impl FileBuilder

pub fn new() -> Self

Gets the default file dialog builder.

pub fn add_filter(self, name: impl AsRef<str>, extensions: &[&str]) -> Self

Add file extension filter. Takes in the name of the filter, and list of extensions

pub fn set_directory<P: AsRef<Path>>(self, directory: P) -> Self

Set starting directory of the dialog.

pub fn set_file_name(self, file_name: &str) -> Self

Set starting file name of the dialog.

pub fn set_title(self, title: &str) -> Self

Set the title of the dialog.

impl FileBuilder

pub fn pick_file(self) -> Option<PathBuf>

Shows the dialog to select a single file. This is a blocking operation, and should NOT be used when running on the main thread context.

Examples

use e_utils::dialog::blocking::FileBuilder;
#[tokio::main]
async fn my_command() {
  let file_path = FileBuilder::new().pick_file();
  // do something with the optional file path here
  // the file path is `None` if the user closed the dialog
}

pub fn pick_files(self) -> Option<Vec<PathBuf>>

Shows the dialog to select multiple files. This is a blocking operation, and should NOT be used when running on the main thread context.

Examples

use e_utils::dialog::blocking::FileBuilder;
#[tokio::main]
async fn my_command() {
  let file_path = FileBuilder::new().pick_files();
  // do something with the optional file paths here
  // the file paths value is `None` if the user closed the dialog
}

pub fn pick_folder(self) -> Option<PathBuf>

Shows the dialog to select a single folder. This is a blocking operation, and should NOT be used when running on the main thread context.

Examples

use e_utils::dialog::blocking::FileBuilder;
#[tokio::main]
async fn my_command() {
  let folder_path = FileBuilder::new().pick_folder();
  // do something with the optional folder path here
  // the folder path is `None` if the user closed the dialog
}

pub fn pick_folders(self) -> Option<Vec<PathBuf>>

Shows the dialog to select multiple folders. This is a blocking operation, and should NOT be used when running on the main thread context.

Examples

use e_utils::dialog::blocking::FileBuilder;
#[tokio::main]
async fn my_command() {
  let folder_paths = FileBuilder::new().pick_folders();
  // do something with the optional folder paths here
  // the folder paths value is `None` if the user closed the dialog
}

pub fn save_file(self) -> Option<PathBuf>

Shows the dialog to save a file. This is a blocking operation, and should NOT be used when running on the main thread context.

Examples

use e_utils::dialog::blocking::FileBuilder;
#[tokio::main]
async fn my_command() {
  let file_path = FileBuilder::new().save_file();
  // do something with the optional file path here
  // the file path is `None` if the user closed the dialog
}

Trait Implementations

impl Debug for FileBuilder

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

Formats the value using the given formatter.

impl Default for FileBuilder

fn default() -> FileBuilder

Returns the “default value” for a type.