トースト ヘッダー

フライトリマインダー、パッケージ追跡など、カテゴリ別に通知を視覚的にグループ化することもできます。

トーストにヘッダーを追加する

トースト通知にヘッダーを追加する方法を次に示します。

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

<toast>

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

    <visual>
        ...
    </visual>

</toast>

概要...

1. ToastContent にヘッダーを追加する
2. 必要なプロパティとして、ID、タイトル、および 引数 を割り当てます。
3. 通知を送信する (詳細)
4. 別の通知では、同じヘッダー Id を使用し、ヘッダーの下に統一します。 Id は、通知をグループ化する必要があるかどうかを判断するために使用される唯一のプロパティです。つまり、タイトルと引数は異なる場合があります。 グループ内の最新の通知から タイトル および 引数 が使用されます。 その通知が削除されると、 タイトル と 引数は 次の最新の通知にフォールバックします。

ヘッダーからのアクティブ化を処理する

ヘッダーはユーザーがクリックできるため、ユーザーはヘッダーをクリックしてアプリから詳細を確認できます。

そのため、アプリは、トースト自体の起動 引数 と同様に、ヘッダーに引数を指定できます。

アクティブ化は通常のトーストのアクティブ化と同じように処理されます。つまり、ユーザーがトーストの本文またはトーストのボタンをクリックしたときと同様に、の App.xaml.cs メソッドでこれらの引数を取得できます。

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 トースト コンテンツ全体を 5 KB より大きくできないことです。

ヘッダーを作成しても、[詳細を表示] ボタンが表示される前にアクション センター内に表示される通知の数は変更されません (この数は既定では 3 であり、通知のシステム設定で各アプリのユーザーが構成できます)。

アプリのタイトルをクリックするのと同じようにヘッダーをクリックしても、このヘッダーに属する通知はクリアされません (アプリでは、関連する通知をクリアするためにトースト API を使用する必要があります)。

関連トピック

• ローカル トーストを送信し、アクティベーションを処理する
• トーストコンテンツ ドキュメンテーション