winio 0.11.0

Single-threaded async GUI runtime based on compio.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

use std::path::PathBuf;

use winio_handle::MaybeBorrowedWindow;

use crate::{sys, sys::Result};

/// File open/save box.
#[derive(Debug, Default, Clone)]
pub struct FileBox(sys::FileBox);

impl FileBox {
    /// Create [`FileBox`].
    pub fn new() -> Self {
        Self(sys::FileBox::new())
    }

    /// Box title.
    pub fn title(mut self, title: impl AsRef<str>) -> Self {
        self.0.title(title.as_ref());
        self
    }

    /// Default filename.
    pub fn filename(mut self, filename: impl AsRef<str>) -> Self {
        self.0.filename(filename.as_ref());
        self
    }

    /// Set file filters.
    pub fn filters(mut self, filters: impl IntoIterator<Item = FileFilter>) -> Self {
        self.0.filters(filters.into_iter().map(|f| f.0));
        self
    }

    /// Add a file filter.
    pub fn add_filter(mut self, filter: impl Into<FileFilter>) -> Self {
        self.0.add_filter(filter.into().0);
        self
    }

    /// Show open file dialog.
    pub async fn open(self, parent: impl Into<MaybeBorrowedWindow<'_>>) -> Result<Option<PathBuf>> {
        self.0.open(parent.into().0).await
    }

    /// Show open file dialog, allowing multiple selection.
    pub async fn open_multiple(
        self,
        parent: impl Into<MaybeBorrowedWindow<'_>>,
    ) -> Result<Vec<PathBuf>> {
        self.0.open_multiple(parent.into().0).await
    }

    /// Show open file dialog, select folder only.
    pub async fn open_folder(
        self,
        parent: impl Into<MaybeBorrowedWindow<'_>>,
    ) -> Result<Option<PathBuf>> {
        self.0.open_folder(parent.into().0).await
    }

    /// Show save file dialog.
    pub async fn save(self, parent: impl Into<MaybeBorrowedWindow<'_>>) -> Result<Option<PathBuf>> {
        self.0.save(parent.into().0).await
    }
}

/// File type filter.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct FileFilter(sys::FileFilter);

impl FileFilter {
    /// Create [`FileFilter`].
    ///
    /// The pattern should be like `*.txt` or `*.*`.
    pub fn new(name: impl AsRef<str>, pattern: impl AsRef<str>) -> Self {
        Self(sys::FileFilter::new(name.as_ref(), pattern.as_ref()))
    }
}

impl<S: AsRef<str>, P: AsRef<str>> From<(S, P)> for FileFilter {
    fn from((name, pattern): (S, P)) -> Self {
        Self::new(name, pattern)
    }
}