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 byg_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 value is a NUL terminated UTF-8 string. | |
notification |
GVariant |
A |
|
| The data is owned by the caller of the function. | |
flags |
XdpNotificationFlags |
Options for this call. |
|
cancellable |
GCancellable |
Optional |
|
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. |
|
The argument can be NULL. | |
data |
gpointer |
Data to pass to |
|
The argument can be NULL. | |
| The data is owned by the caller of the function. |