Sdílet prostřednictvím

Toast headers

Sadu souvisejících oznámení v Centru akcí můžete vizuálně seskupit pomocí záhlaví oznámení.

Important

vyžaduje Desktop Creators Update a 1.4.0 knihovny oznámení: Pokud chcete zobrazit hlavičky informační zprávy, musíte mít spuštěný desktopový build 15063 nebo novější. K vytvoření záhlaví v obsahu toastu musíte použít verzi 1.4.0 nebo novější knihovny NuGet UWP Community Toolkit Notifications. Hlavičky se podporují jenom v Desktopu.

Jak je vidět níže, tato skupinová konverzace je sjednocená pod jednou hlavičkou "Camping!!". Každá jednotlivá zpráva v konverzaci je samostatné oznámení, které sdílí stejnou hlavičku oznámení.

informační zpráva se záhlavím

Můžete také vizuálně seskupit oznámení podle kategorií, jako jsou připomenutí letů, sledování balíčků a další.

Přidejte záhlaví k toastu

Tady je postup, jak do informačního oznámení přidat záhlaví.

Note

Hlavičky se podporují jenom v Desktopu. Zařízení, která záhlaví nepodporují, jednoduše ignorují záhlaví.

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

In summary...

  1. Přidání záhlaví do informačního
  2. Přiřaďte požadované Id, Názeva Argumenty vlastnosti
  3. Odeslání oznámení (další informace)
  4. V jiném oznámení použijte stejné záhlaví ID ke sjednocení pod záhlavím. Id je jedinou vlastností, která slouží k určení, jestli se mají oznámení seskupit, což znamená, že Název a Argumenty mohou být odlišné. Název a argumenty z nejnovějšího oznámení ve skupině se použijí. Pokud se toto oznámení odebere, Název a Argumenty, se vrátí k dalšímu nejnovějšímu oznámení.

Zpracování aktivace ze záhlaví

Na záhlaví můžou uživatelé kliknout, aby uživatel mohl kliknout na záhlaví a zjistit tak další informace z vaší aplikace.

Aplikace mohou proto v hlavičce poskytovat Argumenty, podobně jako argumenty spuštění na samotném toastu.

Aktivace je zpracována stejně jako normální toast, což znamená, že tyto argumenty můžete načíst v metodě OnActivatedApp.xaml.cs stejně jako když uživatel klikne na text toastu nebo tlačítko na toastu.

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

Additional info

Záhlaví vizuálně odděluje a seskupuje oznámení. Nemění žádnou jinou logistiku týkající se maximálního počtu oznámení, které může aplikace obsahovat (20) a chování seznamu oznámení typu first-in-first-out.

Pořadí oznámení v záhlavích je následující... U dané aplikace se jako první zobrazí nejnovější oznámení z aplikace (a celé skupiny hlaviček, pokud je součástí záhlaví).

Id může být libovolným řetězcem, který si zvolíte. Neexistují žádná omezení délky nebo počtu znaků pro jakoukoli vlastnost v ToastHeader. Jediným omezením je, že celý obsah XML toastu nemůže být větší než 5 KB.

Vytváření hlaviček nezmění počet oznámení zobrazených v Centru akcí před zobrazením tlačítka Zobrazit více (toto číslo je ve výchozím nastavení 3 a uživatel ho může nakonfigurovat pro každou aplikaci v nastavení systému pro oznámení).

Když kliknete na záhlaví, stejně jako na název aplikace, nevymaže žádná oznámení spojená s tímto záhlavím (vaše aplikace by měla použít rozhraní Toast API k vymazání příslušných oznámení).

  • Last updated on