通过

Toast 标题

可以使用通知上的 toast 标头在操作中心内直观地对一组相关通知进行分组。

重要

需要桌面创建者更新和通知库的 1.4.0：必须运行桌面版本 15063 或更高版本才能查看 toast 标头。 必须使用 1.4.0 或更高版本的 UWP 社区工具包通知 NuGet 库 来构造 Toast 内容中的标题。 标头仅在桌面上受支持。

如下所示，此组对话在单个标题“露营！！”下统一。 对话中的每条消息都是共享相同 toast 标头的单独通知。

使用标头 的 吐司

还可以选择按类别直观地对通知进行分组，例如航班提醒、包裹追踪等。

向通知添加标头

下面介绍了如何将标题添加到 Toast 通知。

注释

标头仅在桌面上受支持。 不支持标头的设备只会忽略标头。

new ToastContentBuilder()
    .AddHeader("6289", "Camping!!", "action=openConversation&id=6289")
    .AddText("Anyone have a sleeping bag I can borrow?");

摘要...

  1. 将 标头 添加到 ToastContent
  2. 分配所需的 ID属性、标题属性和 参数 属性
  3. 发送通知（了解详细信息）
  4. 在另一个通知中，使用相同的标头 ID 在标头下统一它们。 ID 是用于确定通知是否应分组的唯一属性，这意味着“标题”和“参数”可能有所不同。 使用组内最新通知的 标题 和 参数。 如果删除该通知，则 标题 和 参数 回退到下一个最新通知。

处理标头中的激活

标头可由用户单击，以便用户可以单击该标头，以便从应用中查找详细信息。

因此，应用可以在标头上提供 参数，类似于 toast 本身上的启动参数。

激活处理方式与 普通 toast 激活相同，这意味着你可以在 OnActivatedApp.xaml.cs 方法中检索这些参数，就像用户单击 toast 的正文或 toast 上的按钮时一样。

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle toast activation
    if (e is ToastNotificationActivatedEventArgs)
    {
        // Arguments specified from the header
        string arguments = (e as ToastNotificationActivatedEventArgs).Argument;
    }
}

其他信息

标头直观地分隔和对通知进行分组。 它不会更改应用可以拥有的最大通知数量（20个）和通知列表的先进先出特性的任何其他细节。

标头中的通知顺序如下：对于特定的应用程序，该应用程序的最新通知（如果属于一个标头组，则包括整个标头组）将首先出现。

ID 可以是所选的任何字符串。 ToastHeader 中的任何属性都不存在长度或字符限制。 唯一的约束是，整个 XML Toast 内容不能大于 5 KB。

创建标头不会在“查看更多”按钮出现之前更改作中心中显示的通知数（此数字默认为 3，用户可以在系统设置中为每个应用配置通知）。

单击标头（就像单击应用标题一样），不会清除属于此标头的任何通知（应用应使用 Toast API 清除相关通知）。