Struct Notification

pub struct Notification { /* private fields */ }

GNotification is a mechanism for creating a notification to be shown to the user — typically as a pop-up notification presented by the desktop environment shell.

The key difference between GNotification and other similar APIs is that, if supported by the desktop environment, notifications sent with GNotification will persist after the application has exited, and even across system reboots.

Since the user may click on a notification while the application is not running, applications using GNotification should be able to be started as a D-Bus service, using Application.

In order for GNotification to work, the application must have installed a .desktop file. For example:

[Desktop Entry]
Name=Test Application
Comment=Description of what Test Application does
Exec=gnome-test-application
Icon=org.gnome.TestApplication
Terminal=false
Type=Application
Categories=GNOME;GTK;TestApplication Category;
StartupNotify=true
DBusActivatable=true
X-GNOME-UsesNotifications=true

The X-GNOME-UsesNotifications key indicates to GNOME Control Center that this application uses notifications, so it can be listed in the Control Center’s ‘Notifications’ panel.

The .desktop file must be named as org.gnome.TestApplication.desktop, where org.gnome.TestApplication is the ID passed to Application::new().

User interaction with a notification (either the default action, or buttons) must be associated with actions on the application (ie: app. actions). It is not possible to route user interaction through the notification itself, because the object will not exist if the application is autostarted as a result of a notification being clicked.

A notification can be sent with ApplicationExt::send_notification().

Implements

[trait@glib::ObjectExt]

GLib type: GObject with reference counted clone semantics.

Implementations

impl Notification

pub fn new(title: &str) -> Notification

Creates a new #GNotification with @title as its title.

After populating @notification with more details, it can be sent to the desktop shell with g_application_send_notification(). Changing any properties after this call will not have any effect until resending @notification.

title

the title of the notification

Returns

a new #GNotification instance

pub fn add_button(&self, label: &str, detailed_action: &str)

Adds a button to @self that activates the action in @detailed_action when clicked. That action must be an application-wide action (starting with “app.”). If @detailed_action contains a target, the action will be activated with that target as its parameter.

See g_action_parse_detailed_name() for a description of the format for @detailed_action.

label

label of the button

detailed_action

a detailed action name

pub fn add_button_with_target_value( &self, label: &str, action: &str, target: Option<&Variant>, )

Adds a button to @self that activates @action when clicked. @action must be an application-wide action (it must start with “app.”).

If @target is non-None, @action will be activated with @target as its parameter.

label

label of the button

action

an action name

target

a #GVariant to use as @action’s parameter, or None

pub fn set_body(&self, body: Option<&str>)

Sets the body of @self to @body.

body

the new body for @self, or None

pub fn set_category(&self, category: Option<&str>)

Available on crate feature v2_70 only.

Sets the type of @self to @category. Categories have a main type like email, im or device and can have a detail separated by a ., e.g. im.received or email.arrived. Setting the category helps the notification server to select proper feedback to the user.

Standard categories are listed in the specification.

category

the category for @self, or None for no category

pub fn set_default_action(&self, detailed_action: &str)

Sets the default action of @self to @detailed_action. This action is activated when the notification is clicked on.

The action in @detailed_action must be an application-wide action (it must start with “app.”). If @detailed_action contains a target, the given action will be activated with that target as its parameter. See g_action_parse_detailed_name() for a description of the format for @detailed_action.

When no default action is set, the application that the notification was sent on is activated.

detailed_action

a detailed action name

pub fn set_default_action_and_target_value( &self, action: &str, target: Option<&Variant>, )

Sets the default action of @self to @action. This action is activated when the notification is clicked on. It must be an application-wide action (start with “app.”).

If @target is non-None, @action will be activated with @target as its parameter. If @target is floating, it will be consumed.

When no default action is set, the application that the notification was sent on is activated.

action

an action name

target

a #GVariant to use as @action’s parameter, or None

pub fn set_icon(&self, icon: &impl IsA<Icon>)

Sets the icon of @self to @icon.

icon

the icon to be shown in @self, as a #GIcon

pub fn set_priority(&self, priority: NotificationPriority)

Sets the priority of @self to @priority. See #GNotificationPriority for possible values.

priority

a #GNotificationPriority

pub fn set_title(&self, title: &str)

Sets the title of @self to @title.

title

the new title for @self

Trait Implementations

impl Clone for Notification

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

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

Performs copy-assignment from source.

impl Debug for Notification

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

Formats the value using the given formatter.

impl HasParamSpec for Notification

type ParamSpec = ParamSpecObject

type SetValue = Notification

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, Notification>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for Notification

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

where H: Hasher,

Hashes the memory address of this object.

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 Ord for Notification

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl ParentClassIs for Notification

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for Notification

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

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

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<OT: ObjectType> PartialOrd<OT> for Notification

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Notification

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Notification