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().
This method completes asynchronously. Use xdp_portal_add_notification_finish() inside the GAsyncReadyCallback to obtain the result of the operation.
Parameters
- id
- 
            Type: const char*Unique ID for the notification. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. 
- notification
- 
            Type: GVariantA GVariantdictionary with the content of the notification.The data is owned by the caller of the method. 
- flags
- 
            Type: XdpNotificationFlagsOptions for this call. 
- cancellable
- 
            Type: GCancellableOptional GCancellable.The argument can be NULL.The data is owned by the caller of the method. 
- callback
- 
            Type: GAsyncReadyCallbackA callback to call when the request is done. The argument can be NULL.
- data
- 
            Type: gpointerData to pass to callback.The argument can be NULL.The data is owned by the caller of the method.