Struct tauri::SystemTray
source · [−]#[non_exhaustive]pub struct SystemTray {
pub id: String,
pub icon: Option<Icon>,
pub menu: Option<SystemTrayMenu>,
/* private fields */
}
Expand description
Represents a System Tray instance.
Fields (Non-exhaustive)
This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.id: String
The tray identifier. Defaults to a random string.
icon: Option<Icon>
The tray icon.
The tray menu.
Implementations
sourceimpl SystemTray
impl SystemTray
sourcepub fn new() -> Self
pub fn new() -> Self
Creates a new system tray that only renders an icon.
Examples
use tauri::SystemTray;
tauri::Builder::default()
.setup(|app| {
let tray_handle = SystemTray::new().build(app)?;
Ok(())
});
sourcepub fn with_id<I: Into<String>>(self, id: I) -> Self
pub fn with_id<I: Into<String>>(self, id: I) -> Self
Sets the tray identifier, used to retrieve its handle and to identify a tray event source.
Examples
use tauri::SystemTray;
tauri::Builder::default()
.setup(|app| {
let tray_handle = SystemTray::new()
.with_id("tray-id")
.build(app)?;
Ok(())
});
sourcepub fn with_icon<I: TryInto<Icon>>(self, icon: I) -> Selfwhere
I::Error: Error,
pub fn with_icon<I: TryInto<Icon>>(self, icon: I) -> Selfwhere
I::Error: Error,
Sets the tray Icon
.
Examples
use tauri::{Icon, SystemTray};
tauri::Builder::default()
.setup(|app| {
let tray_handle = SystemTray::new()
// dummy and invalid Rgba icon; see the Icon documentation for more information
.with_icon(Icon::Rgba { rgba: Vec::new(), width: 0, height: 0 })
.build(app)?;
Ok(())
});
sourcepub fn on_event<F: Fn(SystemTrayEvent) + Send + Sync + 'static>(
self,
f: F
) -> Self
pub fn on_event<F: Fn(SystemTrayEvent) + Send + Sync + 'static>(
self,
f: F
) -> Self
Sets the event listener for this system tray.
Examples
use tauri::{Icon, Manager, SystemTray, SystemTrayEvent};
tauri::Builder::default()
.setup(|app| {
let handle = app.handle();
let id = "tray-id";
SystemTray::new()
.with_id(id)
.on_event(move |event| {
let tray_handle = handle.tray_handle_by_id(id).unwrap();
match event {
// show window with id "main" when the tray is left clicked
SystemTrayEvent::LeftClick { .. } => {
let window = handle.get_window("main").unwrap();
window.show().unwrap();
window.set_focus().unwrap();
}
_ => {}
}
})
.build(app)?;
Ok(())
});
Sets the menu to show when the system tray is right clicked.
Examples
use tauri::{CustomMenuItem, SystemTray, SystemTrayMenu};
tauri::Builder::default()
.setup(|app| {
let tray_handle = SystemTray::new()
.with_menu(
SystemTrayMenu::new()
.add_item(CustomMenuItem::new("quit", "Quit"))
.add_item(CustomMenuItem::new("open", "Open"))
)
.build(app)?;
Ok(())
});
sourcepub fn build<R: Runtime, M: Manager<R>>(
self,
manager: &M
) -> Result<SystemTrayHandle<R>>
pub fn build<R: Runtime, M: Manager<R>>(
self,
manager: &M
) -> Result<SystemTrayHandle<R>>
Builds and shows the system tray.
Examples
use tauri::{CustomMenuItem, SystemTray, SystemTrayMenu};
tauri::Builder::default()
.setup(|app| {
let tray_handle = SystemTray::new()
.with_menu(
SystemTrayMenu::new()
.add_item(CustomMenuItem::new("quit", "Quit"))
.add_item(CustomMenuItem::new("open", "Open"))
)
.build(app)?;
tray_handle.get_item("quit").set_enabled(false);
Ok(())
});
Trait Implementations
sourceimpl Clone for SystemTray
impl Clone for SystemTray
sourcefn clone(&self) -> SystemTray
fn clone(&self) -> SystemTray
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read moresourceimpl Debug for SystemTray
impl Debug for SystemTray
Auto Trait Implementations
impl !RefUnwindSafe for SystemTray
impl Send for SystemTray
impl Sync for SystemTray
impl Unpin for SystemTray
impl !UnwindSafe for SystemTray
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more