native-dialog 0.9.3

A library to display dialogs. Supports GNU/Linux, BSD Unix, macOS and Windows.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# native-dialog

[![Crates.io](https://img.shields.io/crates/v/native-dialog.svg)](https://crates.io/crates/native-dialog)
[![Docs.rs](https://docs.rs/native-dialog/badge.svg)](https://docs.rs/native-dialog)
[![License](https://img.shields.io/crates/l/native-dialog.svg)](LICENSE)

A library to display file choosers and message boxes. Supports GNU/Linux, BSD, macOS and Windows.

## Installation

```
cargo add native-dialog
```

## Usage

```rust
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](examples/windows_manifest) and [examples/windows_features](examples/windows_features) for example.

#### Linux/BSD dependencies

The implementation for Linux and BSD requires either [Zenity](https://gitlab.gnome.org/GNOME/zenity), [KDialog](https://invent.kde.org/utilities/kdialog), or [YAD](https://github.com/v1cont/yad) being installed; otherwise the `MissingDep` error will be returned.