Method

XdpPortaladd_notification

Declaration [src]

void
xdp_portal_add_notification (
  XdpPortal* portal,
  const char* id,
  GVariant* notification,
  XdpNotificationFlags flags,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer data
)

Description [src]

Sends a desktop notification.

The following keys may be present in notification:

title s: a user-visible string to display as title
body s: a user-visible string to display as body
icon v: a serialized icon (in the format produced by g_icon_serialize())
priority s: “low”, “normal”, “high” or “urgent”
default-action s: name of an action that will be activated when the user clicks on the notification
default-action-target v: target parameter to send along when activating the default action.
buttons aa{sv}: array of serialized buttons

Each serialized button is a dictionary with the following supported keys:

label s: user-visible lable for the button. Mandatory
action s: name of an action that will be activated when the user clicks on the button. Mandatory
target v: target parameter to send along when activating the button

Actions with a prefix of “app.” are assumed to be exported by the application and will be activated via the org.freedesktop.Application interface, others are activated by emitting the XdpPortal::notification-action-invoked signal.

It is the callers responsibility to ensure that the ID is unique among all notifications.

To withdraw a notification, use xdp_portal_remove_notification().

Parameters

`id`	`const char*`
	Unique ID for the notification.
	The data is owned by the caller of the function.
	The string is a NUL terminated UTF-8 string.
`notification`	`GVariant*`
	A `GVariant` dictionary with the content of the notification.
	The data is owned by the caller of the function.
`flags`	`XdpNotificationFlags`
	Options for this call.
`cancellable`	`GCancellable*`
	Optional `GCancellable`
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`callback`	`GAsyncReadyCallback`
	A callback to call when the request is done.
`data`	`gpointer`
	Data to pass to `callback`.