Заголовки всплывающих уведомлений

  • Статья

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

Важно!

Требуется обновление Desktop Creators Update и библиотека уведомлений версии 1.4.0. Для просмотра заголовков всплывающих уведомлений необходимо использовать сборку desktop 15063 или более поздней версии. Для создания заголовка в содержимом всплывающего уведомления необходимо использовать версию 1.4.0 или более позднюю библиотеку уведомлений UWP Community Toolkit . Заголовки поддерживаются только на настольных компьютерах.

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

Уведомления с заголовком

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

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

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

Примечание

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

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

Краткие сведения...

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

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

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

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

Активация обрабатывается так же, как активация обычного всплывающего уведомления, то есть вы можете получить эти аргументы в методе OnActivated класса 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 КБ.

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

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