Gio.Application.send_notification

### Method

# Gio Applicationsend_notification

since: 2.40

#### Declaration [src]

    void
    g_application_send_notification (
      GApplication* application,
      const gchar* id,
      GNotification* notification
    )

#### Description [src]

Sends a notification on behalf of `application` to the desktop shell. There is no guarantee that the notification is displayed immediately, or even at all.

Notifications may persist after the application exits. It will be D-Bus-activated when the notification or one of its actions is activated.

Modifying `notification` after this call has no effect. However, the object can be reused for a later call to this function.

`id` may be any string that uniquely identifies the event for the application. It does not need to be in any special format. For example, “new-message” might be appropriate for a notification about new messages.

If a previous notification was sent with the same `id`, it will be replaced with `notification` and shown again as if it was a new notification. This works even for notifications sent from a previous execution of the application, as long as `id` is the same string.

`id` may be `NULL`, but it is impossible to replace or withdraw notifications without an id.

If `notification` is no longer relevant, it can be withdrawn with `g_application_withdraw_notification()`.

It is an error to call this function if `application` has no application ID.

Available since: 2.40

#### Parameters

`id`

  Type: `const gchar*`

  Id of the notification, or `NULL`.

  The argument can be `NULL`.
  The data is owned by the caller of the method.
  The value is a NUL terminated UTF-8 string.

`notification`

  Type: `GNotification`

  The `GNotification` to send.

  The data is owned by the caller of the method.