通过

Toast 标头

  • 项目

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

重要

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

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

带有标头的 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 激活相同，这意味着你可以在 OnActivated 方法App.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 清除相关通知）。