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


ToastNotificationManager Класс

Определение

Создает объекты 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)]
class ToastNotificationManager final
/// [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)]
public static class ToastNotificationManager
[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
Атрибуты

Требования к 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.
  • Классические приложения не могут запланировать всплывающее уведомление.

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

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

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

Применяется к

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