rgpui 1.3.0

GUI UI framework
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

//! Window 扩展 trait - 为 Window 添加对话框打开/关闭等能力。

use crate::dialog::{AlertDialog, Dialog};
use crate::{App, DialogId, Root, Window};

/// 为 [`Window`] 添加对话框等功能的扩展 trait。
pub trait WindowExt: Sized {
    /// 打开一个对话框，返回其标识（凭此按标识关闭）。
    fn open_dialog<F>(&mut self, cx: &mut App, build: F) -> DialogId
    where
        F: Fn(Dialog, &mut Window, &mut App) -> Dialog + 'static;

    /// 打开一个警告对话框（带便捷默认值的对话框），返回其标识。
    fn open_alert_dialog<F>(&mut self, cx: &mut App, build: F) -> DialogId
    where
        F: Fn(AlertDialog, &mut Window, &mut App) -> AlertDialog + 'static;

    /// 返回是否存在活动对话框。
    fn has_active_dialog(&mut self, cx: &mut App) -> bool;

    /// 关闭最后一个活动对话框。
    fn close_dialog(&mut self, cx: &mut App);

    /// 按标识关闭指定对话框（栈中任意位置，上层不受影响）。
    ///
    /// 找到并移除返回 `true`，未知标识返回 `false`。
    fn close_dialog_by(&mut self, cx: &mut App, id: DialogId) -> bool;

    /// 关闭所有活动对话框。
    fn close_all_dialogs(&mut self, cx: &mut App);
}

impl WindowExt for Window {
    #[inline]
    fn open_dialog<F>(&mut self, cx: &mut App, build: F) -> DialogId
    where
        F: Fn(Dialog, &mut Window, &mut App) -> Dialog + 'static,
    {
        Root::update(self, cx, move |root, window, cx| {
            root.open_dialog(build, window, cx)
        })
    }

    #[inline]
    fn open_alert_dialog<F>(&mut self, cx: &mut App, build: F) -> DialogId
    where
        F: Fn(AlertDialog, &mut Window, &mut App) -> AlertDialog + 'static,
    {
        self.open_dialog(cx, move |_, window, cx| {
            build(AlertDialog::new(cx), window, cx).into_dialog(window, cx)
        })
    }

    #[inline]
    fn has_active_dialog(&mut self, cx: &mut App) -> bool {
        Root::read(self, cx).active_dialogs.len() > 0
    }

    #[inline]
    fn close_dialog(&mut self, cx: &mut App) {
        Root::update(self, cx, |root, window, cx| {
            root.close_dialog(window, cx);
        })
    }

    #[inline]
    fn close_dialog_by(&mut self, cx: &mut App, id: DialogId) -> bool {
        Root::update(self, cx, |root, window, cx| {
            root.close_dialog_by(id, window, cx)
        })
    }

    #[inline]
    fn close_all_dialogs(&mut self, cx: &mut App) {
        Root::update(self, cx, |root, window, cx| {
            root.close_all_dialogs(window, cx);
        })
    }
}