Enum Hint 

pub enum Hint {
    ActionIcons(bool),
    Category(String),
    DesktopEntry(String),
    ImagePath(String),
    Resident(bool),
    SoundFile(String),
    SoundName(String),
    SuppressSound(bool),
    Transient(bool),
    X(i32),
    Y(i32),
    Urgency(Urgency),
    Custom(String, String),
    CustomInt(String, i32),
    Invalid,
}

Hints allow you to pass extra information to the notification server.

Many of these are standardized by:

• https://specifications.freedesktop.org/notification-spec/latest/hints.html

Which hints are actually implemented depends strongly on the notification server you talk to. Usually get_capabilities() gives some clues, but the standard usually mentions much more than is actually available.

Pass these to Notification::hint.

Variants

ActionIcons(bool)

If true, server may interpret action identifiers as named icons and display those.

Category(String)

Check out:

• https://specifications.freedesktop.org/notification-spec/latest/hints.html

DesktopEntry(String)

Name of the DesktopEntry representing the calling application. In case of "firefox.desktop" use "firefox". May be used to retrieve the correct icon.

ImagePath(String)

Display the image at this path.

Resident(bool)

This does not work on all servers, however timeout=0 will do the job

SoundFile(String)

Play the sound at this path.

SoundName(String)

A themeable named sound from the freedesktop.org sound naming specification to play when the notification pops up. Similar to icon-name, but for sounds. An example would be "message-new-instant".

SuppressSound(bool)

Suppress the notification sound.

Transient(bool)

When set, the server will treat the notification as transient and bypass the server’s persistence capability, if it exists.

X(i32)

Lets the notification point to a certain ‘x’ position on the screen. Requires Y.

Y(i32)

Lets the notification point to a certain ‘y’ position on the screen. Requires X.

Urgency(Urgency)

Pass a Urgency, either Low, Normal, or Critical.

Custom(String, String)

If you want to pass something entirely different.

CustomInt(String, i32)

A custom numerical (integer) hint

Invalid

Only used by this NotificationServer implementation.

Implementations

impl Hint

pub fn as_bool(&self) -> Option<bool>

Get the bool representation of this hint.

pub fn as_i32(&self) -> Option<i32>

Get the i32 representation of this hint.

pub fn as_str(&self) -> Option<&str>

Get the &str representation of this hint.

pub fn from_key_val(name: &str, value: &str) -> Result<Hint, String>

Convenience function for converting a name and value into a hint.

Trait Implementations

impl Clone for Hint

fn clone(&self) -> Hint

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Hint

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Hint

impl<'a> From<&'a Hint> for (&'a str, Value<'a>)

Available on Unix and crate feature zbus and non-macOS only.

fn from(val: &'a Hint) -> Self

Converts to this type from the input type.

impl Hash for Hint

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Hint

fn eq(&self, other: &Hint) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Hint