ToastNotificationManager Класс

Определение

Пространство имен:

Windows.UI.Notifications

Создает объекты ToastNotifier , которые используются для создания всплывающих уведомлений. Этот класс также предоставляет доступ к XML-содержимому шаблонов всплывающих уведомлений, предоставляемых системой, чтобы можно было настроить это содержимое для использования в уведомлениях.

public ref class ToastNotificationManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotificationManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class ToastNotificationManager

Public Class ToastNotificationManager

Наследование

Object Platform::Object IInspectable ToastNotificationManager

Атрибуты

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

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

var notifications = Windows.UI.Notifications;

// Get the toast notification manager for the current app.
var notificationManager = notifications.ToastNotificationManager;

// The getTemplateContent method returns a Windows.Data.Xml.Dom.XmlDocument object
// that contains the toast notification XML content.
var template = notifications.toastTemplateType.toastImageAndText01;
var toastXml = notificationManager.getTemplateContent(notifications.ToastTemplateType[template]);

// You can use the methods from the XML document to specify the required elements for the toast.
var images = toastXml.getElementsByTagName("image");
images[0].setAttribute("src", "images/toastImageAndText.png");

var textNodes = toastXml.getElementsByTagName("text");
textNodes.forEach(function (value, index) {
    var textNumber = index + 1;
    var text = "";
    for (var j = 0; j < 10; j++) {
        text += "Text input " + /*@static_cast(String)*/textNumber + " ";
    }
    value.appendChild(toastXml.createTextNode(text));
});

// Create a toast notification from the XML, then create a ToastNotifier object
// to send the toast.
var toast = new notifications.ToastNotification(toastXml);

notificationManager.createToastNotifier().show(toast);

Комментарии

Отправка всплывающих уведомлений из классических приложений

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

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

Дополнительные сведения см. в следующих статьях:

• Включение всплывающих уведомлений рабочего стола через AppUserModelID
• Краткое руководство. Отправка всплывающего уведомления с рабочего стола

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	ConfigureNotificationMirroring
1607	14393	GetForUser
1703	15063	GetDefault

Свойства

History

Возвращает объект ToastNotificationHistory .

Методы

ConfigureNotificationMirroring(NotificationMirroring)	Указывает, разрешено ли зеркальное отображение уведомлений. Зеркальное отображение уведомлений позволяет транслировать уведомления на нескольких устройствах.
CreateToastNotifier()	Создает и инициализирует новый экземпляр ToastNotification, привязанный к вызывающей программе, что позволяет создавать всплывающее уведомление для этого приложения.
CreateToastNotifier(String)	Создает и инициализирует новый экземпляр ToastNotification, привязанный к указанному приложению, обычно к другому приложению в том же пакете.
GetDefault()	Возвращает диспетчер всплывающих уведомлений для текущего пользователя.
GetForUser(User)	Возвращает диспетчер всплывающих уведомлений для указанного пользователя.
GetTemplateContent(ToastTemplateType)	Возвращает XML-содержимое одного из стандартных шаблонов всплывающих уведомлений, чтобы его можно было настроить для использования в уведомлении.

См. также раздел

• Пример всплывающих уведомлений
• Отправка всплывающих уведомлений из примера классического приложения
• Xml-схема всплывающего уведомления
• Общие сведения о всплывающем уведомлении
• Краткое руководство. Отправка всплывающего уведомления
• Краткое руководство. Отправка всплывающего push-уведомления
• Краткое руководство. Отправка всплывающего уведомления с рабочего стола
• Рекомендации и контрольный список для всплывающих уведомлений
• Обработка активации из всплывающего уведомления
• Как согласиться на всплывающие уведомления
• Планирование всплывающего уведомления
• Включение всплывающих уведомлений рабочего стола через AppUserModelID
• Каталог шаблонов всплывающих уведомлений
• Параметры всплывающего уведомления о звуке