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


ToastNotificationManager.CreateToastNotifier Метод

Определение

Перегрузки

CreateToastNotifier()

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

CreateToastNotifier(String)

Создает и инициализирует новый экземпляр ToastNotification, привязанный к указанному приложению, обычно другому приложению в том же пакете.

CreateToastNotifier()

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

public:
 static ToastNotifier ^ CreateToastNotifier();
/// [Windows.Foundation.Metadata.Overload("CreateToastNotifier")]
 static ToastNotifier CreateToastNotifier();
[Windows.Foundation.Metadata.Overload("CreateToastNotifier")]
public static ToastNotifier CreateToastNotifier();
function createToastNotifier()
Public Shared Function CreateToastNotifier () As ToastNotifier

Возвращаемое значение

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

Атрибуты

Примеры

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

Комментарии

Не используйте эту перегрузку при создании всплывающего уведомления для классического приложения. Используйте CreateToastNotifier(appID), чтобы предоставить необходимый идентификатор AppUserModelID.

Если приложение использует агент протокола VOIP в фоновом режиме, оно должно указать идентификатор приложения для отображения всплывающего уведомления. Используйте перегрузку метода CreateToastNotifier(appID).

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

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

CreateToastNotifier(String)

Создает и инициализирует новый экземпляр ToastNotification, привязанный к указанному приложению, обычно другому приложению в том же пакете.

public:
 static ToastNotifier ^ CreateToastNotifier(Platform::String ^ applicationId);
/// [Windows.Foundation.Metadata.Overload("CreateToastNotifierWithId")]
 static ToastNotifier CreateToastNotifier(winrt::hstring const& applicationId);
[Windows.Foundation.Metadata.Overload("CreateToastNotifierWithId")]
public static ToastNotifier CreateToastNotifier(string applicationId);
function createToastNotifier(applicationId)
Public Shared Function CreateToastNotifier (applicationId As String) As ToastNotifier

Параметры

applicationId
String

Platform::String

winrt::hstring

Уникальный идентификатор приложения.

Примечание

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

Возвращаемое значение

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

Атрибуты

Комментарии

Приложение, идентифицируемое applicationId , должно принадлежать тому же пакету, что и вызывающий объект.

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

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

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

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

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

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

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