bevy_tray_icon 0.3.0

Allows the use of tray-icon to manipulate the system tray.
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

use tray_icon::menu;
use tray_icon::menu::accelerator::Accelerator;
use tray_icon::menu::{IsMenuItem, MenuId, PredefinedMenuItem, Submenu};

use crate::resource::Menu;

/// System Tray Menu Item.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
#[non_exhaustive]
pub enum MenuItem {
    /// The menu common item.
    Common {
        /// Menu id.
        id: MenuId,
        /// The text displayed in the menu.
        text: String,
        /// whether you can click on this item.
        enabled: bool,
        /// A keyboard shortcut that consists of an optional combination of modifier keys (provided by Modifiers) and one key (Code).
        accelerator: Option<Accelerator>,
    },

    /// Submenu.
    SubMenu {
        /// Menu id
        id: MenuId,
        /// The text displayed in the menu.
        text: String,
        /// whether you can click on this item.
        enabled: bool,
        /// A keyboard shortcut that consists of an optional combination of modifier keys (provided by Modifiers) and one key (Code).
        menu: Menu,
    },

    /// The menu separator.
    Separator,
}

impl MenuItem {
    /// Creates the common item.
    ///
    /// ## Params
    ///
    /// * `id` - Menu-id.
    /// * `text` - The text displayed in the menu.
    /// * `enabled` - whether you can click on this item.
    /// * `accelerator` - A keyboard shortcut that consists of an optional combination of modifier keys (provided by Modifiers) and one key (Code).
    #[inline]
    pub fn common(
        id: impl Into<MenuId>,
        text: impl Into<String>,
        enabled: bool,
        accelerator: Option<Accelerator>,
    ) -> Self {
        Self::Common {
            id: id.into(),
            text: text.into(),
            enabled,
            accelerator,
        }
    }

    /// Create the separator.
    #[inline]
    pub const fn separator() -> Self {
        Self::Separator
    }

    /// Creates the submenu.
    ///
    /// ## Params
    ///
    /// * `id` - Menu-id.
    /// * `text` - The text displayed in the menu.
    /// * `enabled` - whether you can click on this item.
    /// * `menu` - Submenu
    #[inline]
    pub fn submenu(
        id: impl Into<MenuId>,
        text: impl Into<String>,
        enabled: bool,
        menu: Menu,
    ) -> Self {
        Self::SubMenu {
            id: id.into(),
            text: text.into(),
            enabled,
            menu,
        }
    }

    pub(super) fn as_dyn(&self) -> Box<dyn IsMenuItem> {
        match self {
            MenuItem::Separator => Box::new(PredefinedMenuItem::separator()),
            MenuItem::SubMenu {
                id,
                text,
                enabled,
                menu,
            } => {
                let sub_menu = Submenu::with_id(&id.0, text, *enabled);
                for item in menu.0.iter().map(|item| item.as_dyn()) {
                    sub_menu.append(&*item).unwrap();
                }
                Box::new(sub_menu)
            }
            MenuItem::Common {
                id,
                text,
                enabled,
                accelerator,
            } => {
                let item = menu::MenuItem::with_id(&id.0, text, *enabled, *accelerator);
                Box::new(item)
            }
        }
    }
}