Notification

Notification

Object Hierarchy:

Description:

public class Notification : Object

Notification 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 Notification and other similar APIs is that, if supported by the desktop environment, notifications sent with Notification 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 Notification should be able to be started as a D-Bus service, using Application.

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 send_notification.

Namespace: GLib

Package: gio-2.0

Content:

Creation methods:

public Notification (string title)
Creates a new Notification with title as its title.

Methods:

public void add_button (string label, string detailed_action)
Adds a button to this that activates the action in detailed_action when clicked.
public void add_button_with_target_value (string label, string action, Variant? target)
Adds a button to this that activates action when clicked.
public void set_body (string? body)
Sets the body of this to body.
public void set_default_action (string detailed_action)
Sets the default action of this to detailed_action.
public void set_default_action_and_target_value (string action, Variant? target)
Sets the default action of this to action.
public void set_icon (Icon icon)
Sets the icon of this to icon.
public void set_priority (NotificationPriority priority)
Sets the priority of this to priority.
public void set_title (string title)
Sets the title of this to title.
public void set_urgent (bool urgent)
Deprecated in favor of set_priority.

Inherited Members:

All known members inherited from class GLib.Object