NotificationManager QML 类型

处理 freedesktop.org 兼容的通知请求的通知模型。更多信息...

导入声明import QtApplicationManager.SystemUI 2.0

属性

方法

详细描述

NotificationManager 单例类型仅提供 QML API。

此类型继承自 QAbstractListModel,可以直接用作通知视图中的模型。

此模型中的每个项都对应一个活动通知。

此模型中可用以下角色 - 也可参考 freesktop.org 规范,深入了解这些字段和客户如何填充它们

角色名称类型描述
idint此通知的唯一 ID。
applicationIdstring创建此通知的应用程序的 ID。这可以用于在 ApplicationManager 模型中查找有关该应用程序的信息。

注意: applicationId 角色在此模型中不是唯一的,也不保证其有效性。单个应用程序可以有多个活动通知,另一方面,系统通知根本没有应用程序上下文。

priorityint请参阅 Notification::priority 的客户端文档
summarystring请参阅 Notification::summary 的客户端文档
bodystring请参阅 Notification::body 的客户端文档
categorystring请参阅 Notification::category 的客户端文档
iconurl请参阅 Notification::icon 的客户端文档
imageurl请参阅 Notification::image 的客户端文档
actionsobject请参阅 Notification::actions 的客户端文档
showActionsAsIconsbool请参阅 Notification::showActionsAsIcons 的客户端文档
dismissOnActionbool请参阅 Notification::dismissOnAction 的客户端文档
isClickablebool请参阅 Notification::clickable 的客户端文档
isSytemNotificationurl保留 true,对于来自非应用程序而是来自某些系统服务的通知。对于来自 UI 的通知始终保持 false
isShowingProgressbool请参阅 Notification::showProgress 的客户端文档
progressqreal请参阅 Notification::progress 的客户端文档。
isStickybool请参阅 Notification::sticky 的客户端文档。
timeoutint请参阅 Notification::timeout 的客户端文档。
extendedobject请参阅 Notification::extended 的客户端文档。

实际接收其他进程通知的后端实现完全符合 freedesktop.org 对通知的规范 的 D-Bus 接口。

为了测试目的,可以使用 libnotify 软件包中的 notify-send 工具创建通知。

属性文档

[只读] count : int

此属性包含模型中活动通知的数量。


方法文档

acknowledgeNotification(int id)

当用户确认了由 id 标识的通知(最可能是通过点击它)时,系统 UI 需要调用此函数。


dismissNotification(int id)

当系统 UI 需要取消不再需要的由 id 标识的通知时,需要调用此函数。

通知的创建者将收到关于此取消的通知。


object get(int index)

以 JavaScript 对象的形式检索 index 位置的模型数据。有关预期的对象字段,请参阅 角色名称

如果指定的 index 无效,则返回空对象。


int indexOfNotification(int id)

根据模型将通知 id 映射到其位置。

如果指定的 id 无效,则返回 -1


object notification(int id)

以 JavaScript 对象的形式检索由 id 标识的通知的模型数据。有关预期的对象字段,请参阅 角色名称

如果指定的 id 无效,则返回空对象。


triggerNotificationAction(int id, string actionId)

当用户触发通知操作时,系统 UI 需要调用此函数。

通过 id 识别通知,通过 actionId 识别操作。

注意:您应只使用为给定通知设置的 action-ids(请参阅 actions 角色)。但是,应用程序管理器将接受和转发任何任意字符串。请注意,该字符串在多进程模式下运行时会在会话 D-Bus 上广播。


©2019 Luxoft Sweden AB。本文件中包含的文档贡献版权属于其各自的所有者。本提供的文档是在自由软件基金会发布并由其许可的条件下,根据GNU免费文档许可证版本1.3提供的。Qt及其相关商标是芬兰Qt公司以及/或其他国家和地区的商标。所有其他商标属于其各自所有者的财产。