Поделиться через

Заголовки уведомлений

Вы можете визуально сгруппировать набор связанных уведомлений в Центре уведомлений с помощью заголовка уведомления.

Это важно

Требуется обновление Creators для Desktop и версия 1.4.0 библиотеки Notifications: Для просмотра заголовков тостов необходимо запустить сборку Desktop 15063 или более поздней версии. Для создания заголовка в содержимом всплывающего элемента необходимо использовать библиотеку NuGet с помощью версии 1.4.0 или более поздней версии. Заголовки поддерживаются только на настольном компьютере.

Как показано ниже, этот групповый разговор унифицирован под одним заголовком "Camping!!". Каждое отдельное сообщение в беседе представляет собой всплывающее уведомление с общим заголовком.

Тосты с заголовком

Вы также можете визуально группировать уведомления по категориям, например напоминания о полетах, отслеживание пакетов и многое другое.

Добавление заголовка в всплывающее уведомление

Вот как добавить заголовок во всплывающее уведомление.

Замечание

Заголовки поддерживаются только на настольном компьютере. Устройства, не поддерживающие заголовки, просто игнорируют заголовок.

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

Сводка...

  1. Добавьте заголовок в ToastContent
  2. Назначьте необходимые свойства идентификатор, Titleи аргументы
  3. Отправка уведомления (дополнительные сведения)
  4. В другом уведомлении используйте тот же заголовок Id, чтобы унифицировать их под заголовком. Идентификатор является единственным свойством, используемым для определения, следует ли группировать уведомления, а это значит, что Title и Аргументы могут отличаться. Используются title и Arguments из последнего уведомления в группе. Если это уведомление удаляется, то заголовок и аргументы возвращаются к следующему самому последнему уведомлению.

Обработка активации из заголовка

Заголовки кликабельны для пользователей, чтобы они могли щелкнуть на заголовок и узнать больше о вашем приложении.

Приложения могут предоставлять аргументы в заголовке, аналогичные аргументам запуска в самом всплывающем элементе.

Активация обрабатывается таким же образом, как обычнаяактивация всплывающих уведомлений, что означает, что вы можете получить эти аргументы в методе OnActivatedApp.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), и поведение по принципу «первый пришел — первый ушел» в списке уведомлений.

Порядок уведомлений в заголовках следующий... Для данного приложения самое последнее уведомление от приложения (а также вся группа заголовков, если оно является частью заголовка) появится сначала.

идентификатор может быть любой выбранной строкой. В ToastHeaderнет ограничений на длину или количество символов. Единственное ограничение заключается в том, что всё содержимое XML тоста не может превышать 5 КБ.

Создание заголовков не изменяет количество уведомлений, отображаемых в Центре уведомлений, до появления кнопки "Дополнительные сведения" (по умолчанию это число равно 3 и может быть настроено пользователем для каждого приложения в системных параметрах уведомлений).

Щелчок по заголовку, так же, как щелчок по названию приложения, не очищает уведомления, связанные с этим заголовком (ваше приложение должно использовать технологии уведомлений toast для очистки соответствующих уведомлений).