Udostępnij przez

Toast headers

Możesz wizualnie zgrupować zestaw powiązanych powiadomień w Centrum akcji przy użyciu wyskakującego nagłówka powiadomień.

Important

wymaga aktualizacji dla twórców komputerów i wersji 1.4.0 biblioteki powiadomień: musisz uruchomić kompilację programu Desktop 15063 lub nowszą, aby wyświetlić wyskakujące nagłówki. Aby utworzyć nagłówek w zawartości powiadomienia (toast), należy użyć wersji 1.4.0 lub nowszej biblioteki UWP Community Toolkit Notifications NuGet. Nagłówki są obsługiwane tylko w programie Desktop.

Jak pokazano poniżej, ta konwersacja grupowa jest ujednolicona w jednym nagłówku "Camping!!". Każda indywidualna wiadomość w konwersacji jest oddzielnym wyskakującym powiadomieniem, które ma ten sam nagłówek.

Toasty z nagłówkiem

Możesz również wybrać wizualne grupowanie powiadomień według kategorii, takich jak przypomnienia o locie, śledzenie pakietów i nie tylko.

Dodaj nagłówek do powiadomienia

Oto jak dodać nagłówek do wyskakującego powiadomienia.

Note

Nagłówki są obsługiwane tylko w programie Desktop. Urządzenia, które nie obsługują nagłówków, po prostu ignorują nagłówek.

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

In summary...

  1. Dodaj nagłówek do ToastContent
  2. Przypisz wymagane właściwości Id, Tytułi Argumenty.
  3. Wyślij powiadomienie (dowiedz się więcej)
  4. W innym powiadomieniu użyj tego samego nagłówka Id, aby je połączyć pod tym nagłówkiem. Identyfikator jest jedyną właściwością używaną do określania, czy powiadomienia powinny być pogrupowane, co oznacza, że tytuł i argumenty mogą być różne. Wykorzystywane są Tytuł i Argumenty z najnowszego powiadomienia w grupie. Jeśli to powiadomienie zostanie usunięte, Tytuł i Argumenty przejdą do następnego najnowszego powiadomienia.

Zarządzanie aktywacją z nagłówka

Nagłówki są klikalne, aby użytkownik mógł dowiedzieć się więcej z aplikacji.

W związku z tym aplikacje mogą udostępniać argumenty w nagłówku, podobnie jak argumenty uruchamiania na samym toast.

Aktywacja jest obsługiwana identycznie jak w przypadku normalnej aktywacji toast, co oznacza, że można pobrać te argumenty w metodzie OnActivatedApp.xaml.cs, podobnie jak wtedy, gdy użytkownik kliknie treść powiadomienia toast lub przycisk na powiadomieniu.

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

Nagłówek wizualnie oddziela i grupuje powiadomienia. Nie zmienia żadnych innych zasad logistyki dotyczących maksymalnej liczby powiadomień, które aplikacja może mieć (20) i kolejkowania FIFO na liście powiadomień.

Kolejność powiadomień w nagłówkach jest następująca... W przypadku danej aplikacji najnowsze powiadomienie z aplikacji (oraz cała grupa nagłówków, jeśli jest częścią nagłówka) pojawi się jako pierwsze.

Wybrany przez Ciebie Id może być dowolnym ciągiem znaków. W ToastHeadernie ma żadnych ograniczeń dotyczących długości ani znaków we właściwościach. Jedynym ograniczeniem jest to, że cała zawartość powiadomienia XML nie może być większa niż 5 KB.

Tworzenie nagłówków nie zmienia liczby powiadomień wyświetlanych w Centrum akcji przed wyświetleniem przycisku "Zobacz więcej" (ta liczba jest domyślnie 3 i może być skonfigurowana przez użytkownika dla każdej aplikacji w ustawieniach systemowych dla powiadomień).

Kliknięcie nagłówka, podobnie jak kliknięcie tytułu aplikacji, nie powoduje wyczyszczenia żadnych powiadomień należących do tego nagłówka (aplikacja powinna użyć wyskakujących interfejsów API, aby wyczyścić odpowiednie powiadomienia).

  • Last updated on