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

Заголовки toast

  • Статья

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

Внимание

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

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

Toasts с заголовком

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

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

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

Примечание.

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

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

Сводка...

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

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

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

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

Активация обрабатывается идентично обычной активации всплывающего уведомления, что означает, что эти аргументы можно получить в методе App.xaml.cs OnActivated так же, как и при нажатии пользователем текста всплывающего уведомления или кнопки на всплывающем элементе.

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 и может быть настроено пользователем для каждого приложения в системных параметрах уведомлений).

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