Toast notifications from desktop apps

Desktop apps (including packaged MSIX apps, apps that use sparse packages to obtain package identity, and classic non-packaged desktop apps) can send interactive toast notifications just like Windows apps. However, there are a few different options for desktop apps due to the different activation schemes.

In this article, we list out the options you have for sending a toast notification on Windows 10. Every option fully supports.

• Persisting in Action Center
• Being activatable from both the popup and inside Action Center
• Being activatable while your EXE isn’t running

All options

The table below illustrates your options for supporting toasts within your desktop app, and the corresponding supported features. You can use the table to select the best option for your scenario.

Option	Visuals	Actions	Inputs	Activates in-process
COM activator	вњ”пёЏ	вњ”пёЏ	вњ”пёЏ	вњ”пёЏ
No COM / Stub CLSID	вњ”пёЏ	вњ”пёЏ	вќЊ	вќЊ

Preferred option — COM activator

This is the preferred option that works for desktop apps, and supports all notification features. Don’t be afraid of the «COM activator»; we have a library for C# and C++ apps that makes this very straightforward, even if you’ve never written a COM server before.

Visuals	Actions	Inputs	Activates in-process
вњ”пёЏ	вњ”пёЏ	вњ”пёЏ	вњ”пёЏ

With the COM activator option, you can use the following notification templates and activation types in your app.

Template and activation type	MSIX/sparse package	Classic desktop
ToastGeneric Foreground	вњ”пёЏ	вњ”пёЏ
ToastGeneric Background	вњ”пёЏ	вњ”пёЏ
ToastGeneric Protocol	вњ”пёЏ	вњ”пёЏ
Legacy templates	вњ”пёЏ	вќЊ

If you add the COM activator to your existing MSIX/sparse package app, Foreground/Background and Legacy notification activations will now activate your COM activator instead of your command line.

Alternative option — No COM / Stub CLSID

This is an alternative option if you cannot implement a COM activator. However, you will sacrifice a few features, such as input support (text boxes on toasts) and activating in-process.

Visuals	Actions	Inputs	Activates in-process
вњ”пёЏ	вњ”пёЏ	вќЊ	вќЊ

With this option, if you support classic desktop, you are much more limited in the notification templates and activation types that you can use, as seen below.

Template and activation type	MSIX/sparse package	Classic desktop
ToastGeneric Foreground	вњ”пёЏ	вќЊ
ToastGeneric Background	вњ”пёЏ	вќЊ
ToastGeneric Protocol	вњ”пёЏ	вњ”пёЏ
Legacy templates	вњ”пёЏ	вќЊ

For packaged MSIX apps and apps that use sparse packages, just send toast notifications like a UWP app would. When the user clicks on your toast, your app will be command line launched with the launch args that you specified in the toast.

For classic desktop apps, set up the AUMID so that you can send toasts, and then also specify a CLSID on your shortcut. This can be any random GUID. Don’t add the COM server/activator. You’re adding a «stub» COM CLSID, which will cause Action Center to persist the notification. Note that you can only use protocol activation toasts, as the stub CLSID will break activation of any other toast activations. Therefore, you have to update your app to support protocol activation, and have the toasts protocol activate your own app.

Toast Notification Class

Definition

Defines the content, associated metadata and events, and expiration time of a toast notification.

Windows 10 requirements

Examples

The following example shows how to create and send a toast notification that includes text and images, including use of the ToastNotification constructor.

The following example shows how to listen for and handle the Dismissed event.

Using Event Handlers

The following example shows how to add an event handler for toast activation on running desktop apps. ToastNotifications need to be persisted in a list to maintain a reference to the toast for later callbacks. A similar pattern can be followed for dismissed and expired toast events.

Ensure event handlers are unsubscribed to when no longer needed to avoid memory leaks.

Remarks

• Handling activation guidance
  • UWP Applications should use the OnActivated for handling toast activations.
  • Staring WinRT Build 19041, MSIX and Sparsed Sign Packaged applications are able to use ToastNotificationActionTrigger for handling activations for more details.
  • Desktop apps can use COM activation by following Desktop — Send Local Toast.
  • If none of the activation options fit your application, follow the example in this document for properly using event handlers.

Version history

Windows version	SDK version	Value added
1607	14393	NotificationMirroring
1607	14393	RemoteId
1703	15063	Data
1703	15063	Priority
1903	18362	ExpiresOnReboot

Constructors

Creates and initializes a new instance of the ToastNotification.

Properties

Gets the XML that defines the current toast notification.

Gets or sets additional information about the status of the toast notification.

Gets or sets the time after which a toast notification should not be displayed.

Indicates whether the toast notification will remain in the Notification Center after a reboot.

Gets or sets the group identifier for the notification.

Gets or sets a value that specifies whether notification mirroring is allowed.

Gets or sets the priority of the toast notification.

Gets or sets a remote id for the notification that enables the system to correlate this notification with another one generated on another device.

Gets or sets whether a toast’s pop-up UI is displayed on the user’s screen.

Do not set this property to true in a toast sent to a Windows 8.x device. Doing so will cause a compiler error or a dropped notification.

Gets or sets the unique identifier of this notification within the notification Group.

Events

Occurs when user activates a toast notification through a click or touch. Apps that are running subscribe to this event.

Occurs when a toast notification leaves the screen, either by expiring or being explicitly dismissed by the user. Apps that are running subscribe to this event.

Occurs when an error is caused when Windows attempts to raise a toast notification. Apps that are running subscribe to this event.

Schedule a toast notification

Scheduled toast notifications allow you to schedule a notification to appear at a later time, regardless of whether your app is running at that time. This is useful for scenarios like displaying reminders or other follow-up tasks for the user, where the time and content of the notification is known ahead-of-time.

Note that scheduled toast notifications have a delivery window of 5 minutes. If the computer is turned off during the scheduled delivery time, and remains off for longer than 5 minutes, the notification will be «dropped» as no longer relevant to the user. If you need guaranteed delivery of notifications regardless of how long the computer was off, we recommend using a background task with a time trigger, as illustrated in this code sample.

Desktop applications (both MSIX/sparse packages and classic desktop) have slightly different steps for sending notifications and handling activation. Follow along with the instructions below, however replace ToastNotificationManager with the DesktopNotificationManagerCompat class from the desktop apps documentation.

Prerequisites

To fully understand this topic, the following will be helpful.

• A working knowledge of toast notification terms and concepts. For more information, seeВ Toast and action center overview.
• A familiarity with Windows 10 toast notification content. For more information, see toast content documentation.
• A Windows 10 UWP app project

Step 1: Install NuGet package

Install the Microsoft.Toolkit.Uwp.Notifications NuGet package. Our code sample will use this package. At the end of the article we’ll provide the «plain» code snippets that don’t use any NuGet packages. This package allows you to create toast notifications without using XML.

Step 2: Add namespace declarations

Step 3: Schedule the notification

We’ll use a simple text-based notification reminding a student about the homework they have due today. Construct the notification and schedule it!

Provide a primary key for your toast

If you want to programmatically cancel, remove, or replace the scheduled notification, you need to use the Tag property (and optionally the Group property) to provide a primary key for your notification. Then, you can use this primary key in the future to cancel, remove, or replace the notification.

To see more details on replacing/removing already delivered toast notifications, please see Quickstart: Managing toast notifications in action center (XAML).

Tag and Group combined act as a composite primary key. Group is the more generic identifier, where you can assign groups like «wallPosts», «messages», «friendRequests», etc. And then Tag should uniquely identify the notification itself from within the group. By using a generic group, you can then remove all notifications from that group by using the RemoveGroup API.

Cancel scheduled notifications

To cancel a scheduled notification, you first have to retrieve the list of all scheduled notifications.

Then, find your scheduled toast matching the tag (and optionally group) you specified earlier, and call RemoveFromSchedule().

Win32 non-MSIX/sparse apps must use the ToastNotificationManagerCompat class as seen above. If you use ToastNotificationManager itself, you will receive an element not found exception. All types of apps can use the Compat class and it will work correctly.

Activation handling

See the send a local toast docs to learn more about handling activation. Activation of a scheduled toast notification is handled the same as activation of a local toast notification.

Adding actions, inputs, and more

See the send a local toast docs to learn more about advanced topics like actions and inputs. Actions and inputs work the same in local toasts as they do in scheduled toasts.

Отправка локального всплывающего уведомления из приложений C# Send a local toast notification from C# apps

Всплывающее уведомление — это сообщение о том, что приложение может быть развернуто и доставлено пользователю, пока оно не находится в вашем приложении. A toast notification is a message that your app can construct and deliver to your user while they are not currently inside your app.

Это краткое руководство содержит инструкции по созданию, доставке и отображению всплывающих уведомлений Windows 10 с помощью расширенного содержимого и интерактивных действий. This quickstart walks you through the steps to create, deliver, and display a Windows 10 toast notification using rich content and interactive actions. В этом кратком руководстве используются локальные уведомления, которые являются простейшим уведомлением для реализации. This quickstart uses local notifications, which are the simplest notification to implement. Все типы приложений (WPF, UWP, WinForms, консоль) могут отправлять уведомления. All types of apps (WPF, UWP, WinForms, console) can send notifications!

Если вы пишете приложение C++, см. документацию по C++ UWP или c++ WRL . If you’re writing a C++ app, please see the C++ UWP or C++ WRL documentation.

Шаг 1. Установка пакета NuGet Step 1: Install NuGet package

В решении Visual Studio щелкните правой кнопкой мыши проект, выберите пункт «Управление пакетами NuGet. « и найдите и установите Microsoft.Toolkit.Uwp.Notifications пакет NuGet версии 7,0 или более поздней. Within your Visual Studio solution, right click your project, click «Manage NuGet Packages. « and search for and install the Microsoft.Toolkit.Uwp.Notifications NuGet package version 7.0 or greater.

Платформа .NET Framework настольные приложения, которые по-прежнему используют packages.config, должны быть перенесены в PackageReference, иначе пакеты SDK для Windows 10 не будут ссылаться правильно. .NET Framework desktop apps that still use packages.config must migrate to PackageReference, otherwise the Windows 10 SDKs won’t be referenced correctly. В проекте щелкните правой кнопкой мыши «ссылки» и выберите «перенести packages.config в PackageReference». In your project, right-click on «References», and click «Migrate packages.config to PackageReference».

Приложения WPF для .NET Core 3,0 должны быть обновлены до .NET Core 3,1, в противном случае интерфейсы API будут отсутствовать. .NET Core 3.0 WPF apps must update to .NET Core 3.1, otherwise the APIs will be absent.

Приложения .NET 5 должны использовать один из TFM Windows 10, в противном случае интерфейсы API отправки и управления всплывающими уведомлениями, такие как Show() , будут отсутствовать. .NET 5 apps must use one of the Windows 10 TFMs, otherwise the toast sending and management APIs like Show() will be missing. Задайте для TFM значение net5.0-windows10.0.17763.0 или более. Set your TFM to net5.0-windows10.0.17763.0 or greater.

Этот пакет будет использоваться в нашем примере кода. Our code sample will use this package. Этот пакет позволяет создавать всплывающие уведомления без использования XML, а также позволяет настольным приложениям отправлять уведомления. This package allows you to create toast notifications without using XML, and also allows desktop apps to send toasts.

Шаг 2. отправка всплывающего уведомления Step 2: Send a toast

В Windows 10 содержимое всплывающего уведомления описано с помощью адаптивного языка, который обеспечивает большую гибкость вида уведомления. In Windows 10, your toast notification content is described using an adaptive language that allows great flexibility with how your notification looks. Дополнительные сведения см. в документации по содержимому всплывающего уведомления. For more information, see the toast content documentation.

Начнем с простого текстового уведомления. We’ll start with a simple text-based notification. Создайте содержимое уведомления (с помощью библиотеки уведомлений) и отобразите уведомление. Construct the notification content (using the Notifications library), and show the notification! Обратите внимание, что пространство имен — Microsoft.Toolkit.Uwp.Notifications . Note that the namespace is Microsoft.Toolkit.Uwp.Notifications .

Попробуйте выполнить этот код, и вы увидите уведомление. Try running this code and you should see the notification appear!

Шаг 3. Обработка активации Step 3: Handling activation

После отображения уведомления, скорее всего, нужно будет решить, что пользователь щелкнет уведомление (это означает, что вы покажете конкретное содержимое после того, как пользователь нажмет его, откроете приложение в целом или выполняет действие, когда пользователь щелкнет уведомление). After showing a notification, you likely need to handle the user clicking the notification (whether that means bringing up specific content after the user clicks it, opening your app in general, or performing an action when the user clicks the notification).

Действия по обработке активации различаются для приложений UWP, Desktop (MSIX) и Desktop (неупакованных). The steps for handling activation differ for UWP, Desktop (MSIX), and Desktop (unpackaged) apps.

Когда пользователь щелкает уведомление (или кнопку на уведомлении с активацией переднего плана), будет вызвана надстройка app. XAML. CS , а также будут возвращены добавленные аргументы. When the user clicks your notification (or a button on the notification with foreground activation), your app’s App.xaml.cs OnActivated will be invoked, and the arguments you added will be returned.

App.xaml.cs App.xaml.cs

Вам необходимо инициализировать кадр и активировать окно вашего так же, как ваш код OnLaunched. You must initialize your frame and activate your window just like your OnLaunched code. OnLaunched не вызывается, если пользователь нажимает на всплывающего уведомления, даже если ваше приложение было закрыто и запуск в первый раз. OnLaunched is NOT called if the user clicks on your toast, even if your app was closed and is launching for the first time. Часто рекомендуется комбинировать OnLaunched и OnActivated в методе OnLaunchedOrActivated , так как такая же инициализация должна произойти в обоих. We often recommend combining OnLaunched and OnActivated into your own OnLaunchedOrActivated method since the same initialization needs to occur in both.

Сначала в Package. appxmanifest добавьте: First, in your Package.appxmanifest, add:

1. Объявление для xmlns:com Declaration for xmlns:com
2. Объявление для xmlns:desktop Declaration for xmlns:desktop
3. В атрибуте IgnorableNamespaces : com и desktop In the IgnorableNamespaces attribute, com and desktop
4. Desktop: расширение для Windows. тоастнотификатионактиватион , чтобы объявить идентификатор CLSID для активатора всплывающих уведомлений (используя новый GUID по своему усмотрению). desktop:Extension for windows.toastNotificationActivation to declare your toast activator CLSID (using a new GUID of your choice).
5. Только MSIX: расширение com для активатора com с использованием GUID из шага #4. MSIX only: com:Extension for the COM activator using the GUID from step #4. Не забудьте включить, Arguments=»-ToastActivated» чтобы вы знали о запуске из уведомления. Be sure to include the Arguments=»-ToastActivated» so that you know your launch was from a notification

Package.appxmanifest Package.appxmanifest

Затем в коде запуска приложения (App. XAML. CS OnStartup для WPF) Подпишитесь на событие onstartuped. Then, in your app’s startup code (App.xaml.cs OnStartup for WPF), subscribe to the OnActivated event.

Когда пользователь щелкает любое из уведомлений (или кнопку на уведомлении), произойдет следующее. When the user clicks any of your notifications (or a button on the notification), the following will happen.

Если приложение выполняется в данный момент. If your app is currently running.

1. Событие тоастнотификатионманажеркомпат. OnActivated будет вызвано в фоновом потоке. The ToastNotificationManagerCompat.OnActivated event will be invoked on a background thread.

Если приложение в данный момент закрыто. If your app is currently closed.

1. Будет запущен исполняемый файл приложения, который ToastNotificationManagerCompat.WasCurrentProcessToastActivated() будет возвращать значение true, чтобы указать, что процесс был запущен из-за современной активации и скоро будет вызван обработчик событий. Your app’s EXE will be launched and ToastNotificationManagerCompat.WasCurrentProcessToastActivated() will return true to indicate the process was started due to a modern activation and that the event handler will soon be invoked.
2. Затем в фоновом потоке будет вызвано событие тоастнотификатионманажеркомпат. OnActivated . Then, the ToastNotificationManagerCompat.OnActivated event will be invoked on a background thread.

Когда пользователь щелкает любое из уведомлений (или кнопку на уведомлении), произойдет следующее. When the user clicks any of your notifications (or a button on the notification), the following will happen.

Если приложение выполняется в данный момент. If your app is currently running.

1. Событие тоастнотификатионманажеркомпат. OnActivated будет вызвано в фоновом потоке. The ToastNotificationManagerCompat.OnActivated event will be invoked on a background thread.

Если приложение в данный момент закрыто. If your app is currently closed.

1. Будет запущен исполняемый файл приложения, который ToastNotificationManagerCompat.WasCurrentProcessToastActivated() будет возвращать значение true, чтобы указать, что процесс был запущен из-за современной активации и скоро будет вызван обработчик событий. Your app’s EXE will be launched and ToastNotificationManagerCompat.WasCurrentProcessToastActivated() will return true to indicate the process was started due to a modern activation and that the event handler will soon be invoked.
2. Затем в фоновом потоке будет вызвано событие тоастнотификатионманажеркомпат. OnActivated . Then, the ToastNotificationManagerCompat.OnActivated event will be invoked on a background thread.

В коде запуска приложения (App. XAML. CS OnStartup для WPF) Подпишитесь на событие onstartuped. In your app’s startup code (App.xaml.cs OnStartup for WPF), subscribe to the OnActivated event.

Шаг 4. Обработка удаления Step 4: Handling uninstallation

Ничего делать не нужно. You don’t need to do anything! При удалении приложений UWP все уведомления и другие связанные ресурсы автоматически очищаются. When UWP apps are uninstalled, all notifications and any other related resources are automatically cleaned up.

Ничего делать не нужно. You don’t need to do anything! При удалении MSIX приложений все уведомления и другие связанные ресурсы автоматически очищаются. When MSIX apps are uninstalled, all notifications and any other related resources are automatically cleaned up.

Если в приложении есть приложение удаления, то в нем следует вызвать ToastNotificationManagerCompat.Uninstall(); . If your app has an uninstaller, in your uninstaller you should call ToastNotificationManagerCompat.Uninstall(); . Если приложение является «переносимым приложением» без установщика, рекомендуется вызывать этот метод при выходе из приложения, если у вас нет уведомлений, которые должны быть сохранены после закрытия приложения. If your app is a «portable app» without an installer, consider calling this method upon app exit unless you have notifications that are meant to persist after your app is closed.

Метод удаления очистит все запланированные и текущие уведомления, удалит все связанные с ним значения реестра и удалит все связанные с ними временные файлы, созданные библиотекой. The uninstall method will clean up any scheduled and current notifications, remove any associated registry values, and remove any associated temporary files that were created by the library.

Добавление изображений Adding images

К уведомлениям можно добавлять большое количество содержимого. You can add rich content to notifications. Мы добавим образ встроенного изображения и профиль (переопределение эмблемы приложения). We’ll add an inline image and a profile (app logo override) image.

В уведомлении можно использовать изображения из пакета приложения, локального хранилища приложения или из Интернета. Images can be used from the app’s package, the app’s local storage, or from the web. Начиная с обновления Fall Creators Update размер веб-изображений может быть до 3 МБ для обычных подключений и до 1 МБ для лимитных подключений. As of the Fall Creators Update, web images can be up to 3 MB on normal connections and 1 MB on metered connections. На устройствах без Fall Creators Update размер веб-изображений не должен превышать 200 КБ. On devices not yet running the Fall Creators Update, web images must be no larger than 200 KB.

Образы HTTP поддерживаются только в приложениях UWP/MSIX/sparse, имеющих возможности Интернета в манифесте. Http images are only supported in UWP/MSIX/sparse apps that have the internet capability in their manifest. неMSIXные и разреженные приложения не поддерживают образы HTTP. необходимо загрузить образ в данные локального приложения и ссылаться на него локально. desktop non-MSIX/sparse apps do not support http images; you must download the image to your local app data and reference it locally.

Добавление кнопок и входных данных Adding buttons and inputs

Вы можете добавить кнопки и входные данные, чтобы сделать уведомления интерактивными. You can add buttons and inputs to make your notifications interactive. Кнопки могут запускать приложение переднего плана, протокол или фоновую задачу. Buttons can launch your foreground app, a protocol, or your background task. Мы добавим текстовое поле ответа, кнопку «Like» и кнопку «вид», открывающую изображение. We’ll add a reply text box, a «Like» button, and a «View» button that opens the image.

Активация кнопок переднего плана обрабатывается так же, как и основной текст всплывающего уведомления (будет вызвана надстройка App. XAML. CS OnActivated). The activation of foreground buttons are handled in the same way as the main toast body (your App.xaml.cs OnActivated will be called).

Обратите внимание, что аргументы, добавленные в уведомление верхнего уровня (например, идентификатор диалога), также будут возвращаться при нажатии кнопок, пока кнопки используют API Аддаргумент, как показано выше (если пользовательское назначение аргументов для кнопки, аргументы верхнего уровня не будут включены). Note that arguments added to the top-level toast (like conversation ID) will also be returned when the buttons are clicked, as long as buttons use the AddArgument API as seen above (if you custom assign arguments on a button, the top-level arguments won’t be included).

Обработка активации фона Handling background activation

При указании активации фона всплывающего уведомления (или кнопка внутри всплывающего уведомления), фоновая задача будет выполнен вместо активация приложения переднего плана. When you specify background activation on your toast (or on a button inside the toast), your background task will be executed instead of activating your foreground app.

Подробнее об использовании фоновых задач см. в разделе Поддержка приложения с помощью фоновых задач. For more information on background tasks, please see Support your app with background tasks.

Если вы используете сборки 14393 или более поздней версии, можно использовать в процесс фоновой задачи, которые значительно упрощают вещи. If you are targeting build 14393 or higher, you can use in-process background tasks, which greatly simplify things. Обратите внимание, что в процессе фоновые задачи не сможет запуститься в более старых версиях Windows. Note that in-process background tasks will fail to run on older versions of Windows. Мы будем использовать фоновую задачу в процессе в этом примере кода. We’ll use an in-process background task in this code sample.

Затем в приложении App. XAML. CS Переопределите метод Онбаккграундактиватед. Then in your App.xaml.cs, override the OnBackgroundActivated method. Затем можно получить предварительно определенные аргументы и ввод пользователя, аналогично активации на переднем плане. You can then retrieve the pre-defined arguments and user input, similar to the foreground activation.

App.xaml.cs App.xaml.cs

Для настольных приложений фоновые активации обрабатываются так же, как при активации переднего плана (будет активирован обработчик событий OnActivated ). For desktop applications, background activations are handled the same as foreground activations (your OnActivated event handler will be triggered). После обработки активации можно отключить отображение пользовательского интерфейса и закрыть приложение. You can choose to not show any UI and close your app after handling activation.

Задание времени окончания срока действия Set an expiration time

В Windows 10 все всплывающие уведомления поступают в центр уведомлений после их закрытия или игнорируется пользователем, поэтому пользователь может просмотреть в уведомления, когда всплывающее окно исчезнет. In Windows 10, all toast notifications go in Action Center after they are dismissed or ignored by the user, so users can look at your notification after the popup is gone.

Тем не менее, если сообщение в уведомлении релевантно только для определенного периода времени, необходимо задать время окончания срока действия для всплывающего уведомления, пользователи не смогут увидеть устаревшие сведения из вашего приложения. However, if the message in your notification is only relevant for a period of time, you should set an expiration time on the toast notification so the users do not see stale information from your app. Например, если повышение действует только 12 часов, задайте истечение срока действия, равный 12 часам. For example, if a promotion is only valid for 12 hours, set the expiration time to 12 hours. В следующем коде мы задаем время окончания срока действия, 2 дня. In the code below, we set the expiration time to be 2 days.

По умолчанию и максимальное время окончания срока действия для локального всплывающего уведомления — 3 дня. The default and maximum expiration time for local toast notifications is 3 days.

Предоставить первичный ключ для всплывающего уведомления Provide a primary key for your toast

Если вы хотите удалить или заменить уведомление, которое вы отправляете программным способом, необходимо использовать свойство Tag (и при необходимости свойство Group) для предоставления первичного ключа для уведомления. If you want to programmatically remove or replace the notification you send, you need to use the Tag property (and optionally the Group property) to provide a primary key for your notification. Затем можно использовать этот ключ в будущем для удаления или замены уведомления. Then, you can use this primary key in the future to remove or replace the notification.

Чтобы просмотреть дополнительные сведения о замене или удалении уже доставленного всплывающего уведомления, см. раздел краткое руководство: управление всплывающими уведомлениями в центре уведомлений (XAML). To see more details on replacing/removing already delivered toast notifications, please see Quickstart: Managing toast notifications in action center (XAML).

Tag и Group объединены в качестве составного первичного ключа. Tag and Group combined act as a composite primary key. Группа — это более общий идентификатор, которой можно назначить группам, например «wallPosts», «сообщения», «friendRequests», и т. д. Выберите тег уникальной идентификации уведомления из группы. Group is the more generic identifier, where you can assign groups like «wallPosts», «messages», «friendRequests», etc. And then Tag should uniquely identify the notification itself from within the group. С помощью универсальной группы вы можете удалить все уведомления из группы с помощью RemoveGroup API . By using a generic group, you can then remove all notifications from that group by using the RemoveGroup API.

Очистка уведомлений Clear your notifications

Приложения отвечают за удаление и очистку собственных уведомлений. Apps are responsible for removing and clearing their own notifications. При запуске приложения, мы не очистить автоматически уведомления. When your app is launched, we do NOT automatically clear your notifications.

Windows автоматически удалит уведомление, если пользователь явно нажмет уведомление. Windows will only automatically remove a notification if the user explicitly clicks the notification.

Вот пример того, как приложение для обмена сообщениями должно делать. Here’s an example of what a messaging app should do…

1. Пользователь получает несколько всплывающих уведомлений о новых сообщениях беседы User receives multiple toasts about new messages in a conversation
2. Пользователь выбирает одно из этих всплывающих уведомлений, чтобы открыть диалог User taps one of those toasts to open the conversation
3. Приложение открывает беседу, а затем удаляет все всплывающие уведомления для этой беседы (с помощью RemoveGroup в группе приложения для этой беседы) The app opens the conversation and then clears all toasts for that conversation (by using RemoveGroup on the app-supplied group for that conversation)
4. Центр уведомлений пользователя теперь правильно отражает состояние уведомления, так как слева в центре уведомлений нет устаревших уведомлений для этой беседы. User’s Action Center now properly reflects the notification state, since there are no stale notifications for that conversation left in Action Center.

Подробные сведения о том, как очистить все уведомления или удалить определенные уведомления, см. в разделе краткое руководство: управление всплывающими уведомлениями в центре уведомлений (XAML). To learn about clearing all notifications or removing specific notifications, see Quickstart: Managing toast notifications in action center (XAML).