Expand description
§native-dialog
A library to display file choosers and message boxes. Supports GNU/Linux, BSD, macOS and Windows.
§Installation
cargo add native-dialog
§Usage
use native_dialog::{DialogBuilder, MessageLevel};
let path = DialogBuilder::file()
.set_location("~/Desktop")
.add_filter("PNG Image", &["png"])
.add_filter("JPEG Image", &["jpg", "jpeg"])
.open_single_file()
.show()
.unwrap();
let path = match path {
Some(path) => path,
None => return,
};
// Asyncronous Dialog
let yes = DialogBuilder::message()
.set_level(MessageLevel::Info)
.set_title("Do you want to open the file?")
.set_text(format!("{:#?}", path))
.confirm()
.spawn()
.await
.unwrap();
if yes {
do_something(path).await;
}
§Misc
§Ugly or blurry dialogs on Windows
Turn on crate features or embed manifests into the .exe
to enable visual styling and dpi awareness for your program. Check out examples/windows_manifest and examples/windows_features for example.
§Linux/BSD dependencies
The implementation for Linux and BSD requires either Zenity or Kdialog being installed; otherwise the MissingDep
error will occur.
Modules§
Structs§
- Dialog
Builder - Builder for dialogs.
- File
Dialog Builder - Builder for file dialogs.
- Message
Alert - Message
Confirm - Message
Dialog Builder - Builder for message dialogs.
- Open
Multiple File - Open
Single Dir - Open
Single File - Save
Single File
Enums§
- Error
- Message
Level - The level of the message in the dialog, which usually affects the color or icon in the dialog.