快顯通知標頭

您可以使用通知上的快顯通知標頭，在控制中心內以可視化方式將一組相關的通知分組。

這很重要

需要 Desktop Creators Update 和 1.4.0 的 Notifications 程式庫：您必須執行桌面組建 15063 或更新版本，才能查看提示通知標頭。 您必須使用 1.4.0 版或更新版本的 UWP Community Toolkit Notifications NuGet 程式庫，以在您的快顯通知內容中建構標頭。 只有在桌面版才支援頁首。

如下所示，此群組交談統一標題為「露營！！」。 在交談中，每則訊息都是共用相同通知提示標頭的獨立通知提示。

具有標頭的快顯通知

您也可以選擇將通知依類別分組，例如航班提醒、包裹追蹤等等。

將標頭新增至彈出訊息

以下是添加標題至快顯通知的方式。

備註

只有在桌面版才支援頁首。 不支援標頭的裝置只會忽略標頭。

構建器語法

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

XML

<toast>

    <header
        id="6289"
        title="Camping!!"
        arguments="action=openConversation&amp;id=6289"/>

    <visual>
        ...
    </visual>

</toast>

摘要...

1. 將 標頭 新增至您的 ToastContent
2. 指派必要的 標識符、Title和 Arguments 属性
3. 傳送您的通知（深入瞭解）
4. 在另一個通知中，請使用相同的標頭 標識碼，使它們在標頭下統一。 Id 是用來判斷通知是否應該分組的唯一屬性，這表示 Title 和 Arguments 可以不同。 系統會使用群組內最新通知 Title 和 Arguments。 如果移除該通知，則 Title 和 Arguments 會退回到最近的舊通知。

處理標題的激活

使用者可以點擊標頭，以從您的應用程式獲得更多資訊。

因此，應用程式可以在標頭上提供 自變數，類似於快顯通知本身的啟動自變數。

啟動方式與 一般 Toast 啟動相同，這表示您可以在 App.xaml.cs 方法中擷取這些參數，就像使用者點擊 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）和通知清單的先進先出行為等其他方面。

標頭內的通知順序如下所示：針對指定的應用程式，最先出現的是該應用程式的最新通知（如果它是標頭群組的一部分，則會顯示整個標頭群組）。

識別元可以是您選擇的任何字串。 ToastHeader 中任何屬性都沒有長度或字元的限制。 唯一的條件約束是，您的整個 XML 快顯通知內容不能大於 5 KB。

在 [查看更多] 按鈕出現之前，建立標頭不會變更控制中心內顯示的通知數目（此數字預設為 3，且可由使用者針對系統設定中的每個應用程式設定通知）。

按一下標頭，就像按一下應用程式標題一樣，不會清除屬於此標頭的任何通知（您的應用程式應該使用 toast API 來清除相關的通知）。

相關主題

• 傳送本機通知並處理啟用
• 快顯通知內容檔