Notification QML Type

Holds whether the notification can be acknowledged by the user - typically, by clicking on it. This action is reported via the acknowledged() signal.

The default value is false.

Holds a list of the possible actions the user can choose from. Every key in this map is an actionId and its corresponding value is an actionText. The notification-manager should eiher display the actionText or an icon, depending on the showActionsAsIcons property.

See also actionTriggered().

Holds a multi-line body of text. Each line is a paragraph, and server implementations are free to word wrap dthem as they see fit.

The body may contain simple HTML markup. If the body is omitted, just the summary is displayed.

Holds the type of this notification (optional).

Notifications can optionally have a category indicator. Although neither the client or the server must support this, some may choose to. Servers that implement categories may use them to intelligently display the notification in a specific way, or group notifications of similar types together.

Holds whether the notification manager should dismiss the notification after user action (for example, clicking one of the supplied action texts or images).

The default value is false.

Holds a custom variant property that lets the user attach arbitrary meta-data to this notification.

Holds a URL to an icon associated with this notification (optional).

The icon should identify the application which created this notification.

See also image.

Holds a URL to an image associated with this notification (optional).

The image should not be used to identify the application (see icon for this), but rather when the notification itself can be assigned an image (for example, showing an album cover in a "Now Playing" notification).

See also icon.

Holds the system-wide unique id of this notification.

The id is 0 until this notification is made visible (and thus published to the server). This property is read-only as the id is allocated by the server.

Holds the priority of this notification. The actual value is implementation specific, but ideally any implementation should use the defined values from the freedesktop.org specification, available via the Priority enum:

The default value is Normal.

Holds a floating-point value between [0.0 ... 1.0] which can be used to show a progress-bar on the notification. The special value -1 can be used to request a busy indicator. The default value is -1.

Holds a hint supplied by the client on how to present the actions. If this property is false, the notification actions should be shown in text form. Otherwise, the actionText should be taken as an icon name conforming to the freedesktop.org icon naming specification (in a closed system, these could also be any icon specification string that the notification server understands).

The default value is false.

See also icon.

A boolean value describing whether a progress-bar/busy-indicator should be shown as part of the notification.

The default value is false.

If this property is set to false, the notification should be removed after timeout milliseconds. Otherwise, the notification is "sticky" and should stay visible until the user acknowledges it.

The default value is false.

Holds a single line overview of the notification.

For instance, "You have mail" or "A friend has come online". Generally, it should not exceed 40 characters, though this is not a requirement (server implementations should word wrap it if necessary).

In case of non-sticky notifications, this value specifies after how many milliseconds the notification should be removed from the screen.

The default value is 2000.

See also sticky.

Instructs the system's notification manager to either show or hide this notification. A notification needs to be set visible only once, even if its properties are changed afterwards - these changes are communicated to the server automatically.

The default value is false.

See also show() and hide().

This signal is emitted when this notification was acknowledged on the server side - most likely due to the user clicking on the notification.

Note: The corresponding handler is onAcknowledged.

This signal is emitted when an action identified by actionId of this notification was triggered on the server side.

Note: The corresponding handler is onActionTriggered.

An alias for visible = false.

See also visible.

An alias for visible = true.

See also visible.

Updates notification, which was already shown.

See also show.