A convenience macro for casting a function to a [callback@ActionCallback]. This is much like [func@GObject.CALLBACK]. The function to cast. An action callback function. a #NotifyActionCallback notification The activated action name User provided data check whether a version equal to or greater than `major.minor.micro` is present. required major version required minor version required micro version The reason for which the notification has been closed. Notification not closed. Timeout has expired. It has been dismissed by the user. It has been closed by a call to [method@NotifyNotification.close]. Closed by undefined/reserved reasons. The default expiration time on a notification. The notification never expires. It stays open until closed by the calling API or the user. A passive pop-up notification. #NotifyNotification represents a passive pop-up notification. It can contain summary text, body text, and an icon, as well as hints specifying how the notification should be presented. The notification is rendered by a notification daemon, and may present the notification in any number of ways. As such, there is a clear separation of content and presentation, and this API enforces that. Creates a new #NotifyNotification. The summary text is required, but all other parameters are optional. The new #NotifyNotification. The required summary text. The optional body text. The optional icon theme icon name or filename. Adds an action to a notification. When the action is invoked, the specified callback function will be called, along with the value passed to @user_data. The notification. The action ID. The human-readable action label. The action's callback function. Optional custom data to pass to @callback. An optional function to free @user_data when the notification is destroyed. Clears all actions from the notification. The notification. Clears all hints from the notification. The notification. Synchronously tells the notification server to hide the notification on the screen. %TRUE on success, or %FALSE on error with @error filled in The notification. Gets the activation token of the notification. If an an action is currently being activated, return the activation token. This function is intended to be used in a [callback@ActionCallback] to get the activation token for the activated action, if the notification daemon supports it. The current activation token, or %NULL if none The notification. Returns the closed reason code for the notification. This is valid only after the [signal@Notification::closed] signal is emitted. Since version 0.8.0 the returned value is of type [enum@ClosedReason]. An integer representing the closed reason code (Since 0.8.0 it's also a [enum@ClosedReason]). The notification. Sets the application icon for the notification. If this function is not called or if @app_icon is %NULL, the application icon will be set from the value set via [func@set_app_icon]. a #NotifyNotification The optional icon theme icon name or filename. Sets the application name for the notification. If this function is not called or if @app_name is %NULL, the application name will be set from the value used in [func@init] or overridden with [func@set_app_name]. a #NotifyNotification the localised application name Sets the category of this notification. This can be used by the notification server to filter or display the data in a certain way. The notification. The category. Sets a hint for @key with value @value. If @value is %NULL, a previously set hint for @key is unset. If @value is floating, it is consumed. a #NotifyNotification the hint key the hint value Sets a hint with a byte value. Use [method@Notification.set_hint] instead The notification. The hint. The hint's value. Sets a hint with a byte array value. The length of @value must be passed as @len. Use [method@Notification.set_hint] instead The notification. The hint. The hint's value. The length of the byte array. Sets a hint with a double value. Use [method@Notification.set_hint] instead The notification. The hint. The hint's value. Sets a hint with a 32-bit integer value. Use [method@Notification.set_hint] instead The notification. The hint. The hint's value. Sets a hint with a string value. Use [method@Notification.set_hint] instead The notification. The hint. The hint's value. Sets a hint with an unsigned 32-bit integer value. Use [method@Notification.set_hint] instead The notification. The hint. The hint's value. Sets the icon in the notification from a #GdkPixbuf. Use [method@Notification.set_image_from_pixbuf] instead. The notification. The icon. Sets the image in the notification from a [class@GdkPixbuf.Pixbuf]. The notification. The image. Sets the timeout of the notification. To set the default time, pass %NOTIFY_EXPIRES_DEFAULT as @timeout. To set the notification to never expire, pass %NOTIFY_EXPIRES_NEVER. Note that the timeout may be ignored by the server. The notification. The timeout in milliseconds. Sets the urgency level of this notification. The notification. The urgency level. Tells the notification server to display the notification on the screen. %TRUE if successful. On error, this will return %FALSE and set @error. The notification. Updates the notification text and icon. This won't send the update out and display it on the screen. For that, you will need to call [method@Notification.show]. %TRUE, unless an invalid parameter was passed. The notification to update. The new required summary text. The optional body text. The optional icon theme icon name or filename. The icon of the application for the notification. The name of the application for the notification. The body of the notification. The closed reason of the notification. See [signal@Notification::closed]. The icon-name of the icon to be displayed on the notification. The Id of the notification. The summary of the notification. Emitted when the notification is closed. The urgency level of the notification. Low urgency. Used for unimportant notifications. Normal urgency. Used for most standard notifications. Critical urgency. Used for very important notifications. Adwaita major version component (e.g. 1 if the version is 1.2.3). Adwaita micro version component (e.g. 3 if the version is 1.2.3). Adwaita minor version component (e.g. 2 if the version is 1.2.3). Gets the application icon registered. The registered application icon, set via [func@set_app_icon]. Gets the application name registered. The registered application name, passed to [func@init]. Queries the server capabilities. Synchronously queries the server for its capabilities and returns them in a list. a list of server capability strings. Queries the server for information. Synchronously queries the server for its information, specifically, the name, vendor, server version, and the version of the notifications specification that it is compliant with. %TRUE if successful, and the variables passed will be set, %FALSE on error. The returned strings must be freed with g_free a location to store the server name, or %NULL a location to store the server vendor, or %NULL a location to store the server version, or %NULL a location to store the version the service is compliant with, or %NULL Initialized libnotify. This must be called before any other functions. Starting from 0.8, if the provided @app_name is %NULL, libnotify will try to figure it out from the running application. Before it was not allowed, and was causing libnotify not to be initialized. %TRUE if successful, or %FALSE on error. The name of the application initializing libnotify. Gets whether or not libnotify is initialized. %TRUE if libnotify is initialized, or %FALSE otherwise. Sets the application icon. The optional icon theme icon name or filename. Sets the application name. The name of the application Uninitializes libnotify. This should be called when the program no longer needs libnotify for the rest of its lifecycle, typically just before exitting.