通知管理器 QML 类型
处理 freedesktop.org 相符的通知请求的通知模型。 更多信息...
导入语句 | import QtApplicationManager.SystemUI 2.0 |
属性
- count : int
方法
- acknowledgeNotification(int id)
- dismissNotification(int id)
- object get(int index)
- int indexOfNotification(int id)
- object notification(int id)
- triggerNotificationAction(int id, string actionId)
详细说明
NotificationManager 单例类型仅提供 QML API。
此类型继承自 QAbstractListModel,可以直接用作通知视图中的模型。
此模型中的每个项都对应一个活动通知。
此模型中可用的以下角色 -同时也请参阅 freedesktop.org 规范,以深入了解这些字段以及客户端如何填充它们
角色名称 | 类型 | 描述 |
---|---|---|
id | int | 此通知的唯一 id。 |
applicationId | string | 创建此通知的应用程序的 id。这可以用于在 ApplicationManager 模型中查找有关应用程序的信息。 注意: |
priority | int | 参见 Notification::priority 的客户端文档 |
summary | string | 参见 Notification::summary 的客户端文档 |
body | string | 参见 Notification::body 的客户端文档 |
category | string | 参见 Notification::category 的客户端文档 |
icon | url | 参见Notification::icon的客户端文档 |
图像 | url | 参见Notification::image的客户端文档 |
操作 | 对象 | 参见Notification::actions的客户端文档 |
将操作显示为图标 | 布尔值 | 参见Notification::showActionsAsIcons的客户端文档 |
收到操作后消失 | 布尔值 | 参见Notification::dismissOnAction的客户端文档 |
可认可 | 布尔值 | 参见Notification::acknowledgeable的客户端文档。为了向后兼容,isClickable 也可以用来引用此功能。 |
是系统通知 | url | 对于不是来自应用程序而是来自系统服务的通知,此属性保持true 。对于来自UI应用程序的通知,始终保持false 。 |
正在显示进度 | 布尔值 | 参见Notification::showProgress的客户端文档 |
进度 | qreal | 参见Notification::progress的客户端文档 |
是粘性的 | 布尔值 | 参见Notification::sticky的客户端文档 |
超时 | int | 参见Notification::timeout的客户端文档 |
扩展 | 对象 | 参见Notification::extended的客户端文档 |
实际的后端实现完全符合freedesktop.org specifications中关于通知的D-Bus接口。
为了测试目的,可以使用来自libnotify包的notify-send工具来创建通知。
属性文档
count : int |
此属性保留模型中活动通知的数量。
方法文档
acknowledgeNotification(int id) |
当用户认可通过id标识的通知(最有可能通过点击它)时,系统UI需要调用此函数。
dismissNotification(int id) |
当系统UI需要删除标识为id的通知时,需要调用此函数。
通知的创建者将被告知此删除。
object get(int index) |
以JavaScript对象的形式检索位于index的模型数据。请参阅role names,了解预期的对象字段。
如果指定的index无效,则返回空对象。
object notification(int id) |
以JavaScript对象的形式检索由id标识的通知的模型数据。请参阅role names,了解预期的对象字段。
如果指定的id无效,则返回空对象。
此函数需要在用户触发通知操作时由系统界面调用。除非通知被设置为常驻(dismissOnAction
为 false
),否则通知也会被关闭。
通知通过 id 进行标识,操作通过 actionId 进行标识。
注意:应仅使用为特定通知设置的 action-ids(请参阅 actions 角色)。然而,应用程序管理器将接受并转发任何任意字符串。请注意,在多进程模式下运行时,此字符串将在会话 D-Bus 上广播。
另请参见dismissNotification()。
© 2024 Qt 公司有限公司。本文件中包含的文档贡献是各自所有者的版权。所提供的文档是根据由自由软件基金会发布的GNU自由文档许可证版本1.3的条款许可的。Qt 和相应的商标是世界各地的芬兰和/或其他国家的 Qt 公司有限公司的商标。所有其他商标均为各自所有者的财产。