Struct notifrust::NotificationHandle

source ·

pub struct NotificationHandle { /* private fields */ }

Expand description

A handle to a shown notification.

This keeps a connection alive to ensure actions work on certain desktops.

Implementations§

source §

impl NotificationHandle

source

pub fn wait_for_action<F>(self, invokation_closure: F)where
F: FnOnce(&str),

Waits for the user to act on a notification and then calls invokation_closure with the name of the corresponding action.

source

pub fn close(self)

Manually close the notification

source

pub fn on_close<F>(self, closure: F)where
F: FnOnce(),

Executes a closure after the notification has closed.

pub fn update(&mut self)

Replace the original notification with an updated version

Example

let mut notification = Notification::new().summary("Latest News")
                                          .body("Bayern Dortmund 3:2")
                                          .show()
                                          .unwrap();

std::thread::sleep_ms(1_500);

notification.summary("Latest News (Correction)")
            .body("Bayern Dortmund 3:3");

notification.update();

Watch out for different implementations of the notification server! On plasma5 or instance, you should also change the appname, so the old message is really replaced and not just amended. Xfce behaves well, all others have not been tested by the developer.

source

pub fn id(&self) -> u32

Returns the Handle’s id.

Methods from Deref<Target = Notification>§

source

pub fn appname(&mut self, appname: &str) -> &mut Notification

Overwrite the appname field used for Notification.

Platform Support

Please note that this method has no effect on macOS. Here you can only set the application via set_application()

source

pub fn summary(&mut self, summary: &str) -> &mut Notification

Set the summary.

Often acts as title of the notification. For more elaborate content use the body field.

source

pub fn subtitle(&mut self, subtitle: &str) -> &mut Notification

Set the subtitle.

This is only useful on macOS, it’s not part of the XDG specification and will therefore be eaten by gremlins under your CPU 😈🤘.

source

pub fn image_path(&mut self, path: &str) -> &mut Notification

Wrapper for NotificationHint::ImagePath

source

pub fn sound_name(&mut self, name: &str) -> &mut Notification

Wrapper for NotificationHint::SoundName

source

pub fn body(&mut self, body: &str) -> &mut Notification

Set the content of the body field.

Multiline textual content of the notification. Each line should be treated as a paragraph. Simple html markup should be supported, depending on the server implementation.

source

pub fn icon(&mut self, icon: &str) -> &mut Notification

Set the icon field.

You can use common icon names here, usually those in /usr/share/icons can all be used. You can also use an absolute path to file.

Platform support

macOS does not have support manually setting the icon. However you can pretend to be another app using set_application()

source

pub fn auto_icon(&mut self) -> &mut Notification

Set the icon field automatically.

This looks at your binaries name and uses it to set the icon.t

Platform support

macOS does not have support manually setting the icon. However you can pretend to be another app using set_application()

source

pub fn hint(&mut self, hint: NotificationHint) -> &mut Notification

Adds a hint.

This method will add a hint to the internal hint hashset. Hints must be of type NotificationHint.

Many of these are again wrapped by more convenient functions such as:

sound_name(...)
urgency(...)
image(...) or
- image_data(...)
- image_path(...)

Notification::new().summary("Category:email")
                   .body("This should not go away until you acknoledge it.")
                   .icon("thunderbird")
                   .appname("thunderbird")
                   .hint(NotificationHint::Category("email".to_owned()))
                   .hint(NotificationHint::Resident(true))
                   .show();

Platform support

Most of these hints don’t even have an effect on the big XDG Desktops, they are completely tossed on macOS.

source

pub fn timeout<T: Into<Timeout>>(&mut self, timeout: T) -> &mut Notification

Set the timeout.

This sets the time (in milliseconds) from the time the notification is displayed until it is closed again by the Notification Server. According to specification -1 will leave the timeout to be set by the server and 0 will cause the notification never to expire.

Platform support

This only works on XDG Desktops, macOS does not support manually setting the timeout.

source

pub fn urgency(&mut self, urgency: NotificationUrgency) -> &mut Notification

Set the urgency.

Pick between Medium, Low and High.

Platform support

Most Desktops on linux and bsd are far too relaxed to pay any attention to this. macOS it to cool to even have something like this in it’s spec 😊.

source

pub fn actions(&mut self, actions: Vec<String>) -> &mut Notification

👎Deprecated: please use .action() only

Set actions.

To quote http://www.galago-project.org/specs/notification/0.9/x408.html#command-notify

Actions are sent over as a list of pairs. Each even element in the list (starting at index 0) represents the identifier for the action. Each odd element in the list is the localized string that will be displayed to the user.

There is nothing fancy going on here yet. Carefull! This replaces the internal list of actions!

(xdg only)

source

pub fn action(&mut self, identifier: &str, label: &str) -> &mut Notification

Add an action.

This adds a single action to the internal list of actions.

(xdg only)

source

pub fn id(&mut self, id: u32) -> &mut Notification

Set an Id ahead of time

Setting the id ahead of time allows overriding a known other notification. Though if you want to update a notification, it is easier to use the update() method of the NotificationHandle object that show() returns.

(xdg only)

source