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 string 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. |
|
data |
gpointer |
Data to pass to |