ToastNotificationManager.CreateToastNotifier 方法

  • 参考

定义

命名空间:
Windows.UI.Notifications

重载

CreateToastNotifier()

创建并初始化绑定到调用应用程序的 ToastNotification 的新实例，该实例可让你向该应用发出 Toast 通知。
CreateToastNotifier(String)

创建并初始化 ToastNotification 的新实例，该实例绑定到指定的应用，通常是同一包中的另一个应用。

CreateToastNotifier()

编辑

创建并初始化绑定到调用应用程序的 ToastNotification 的新实例，该实例可让你向该应用发出 Toast 通知。

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

返回

ToastNotifier

用于向应用发送 Toast 通知的对象。

属性
OverloadAttribute

示例

以下示例演示如何创建和发送包含文本和图像的 Toast 通知，包括使用 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);

注解

为桌面应用创建 Toast 通知器时，请勿使用此重载。 使用 CreateToastNotifier (appID) 提供所需的 AppUserModelID。

如果应用使用后台 Internet 语音协议 (VOIP) 代理，则必须指定应用 ID 以显示 toast。 使用 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

应用的唯一 ID。

注意

无法向辅助磁贴发送 Toast 通知，因此这必须是应用磁贴的 ID。

返回

ToastNotifier

用于向磁贴发送 Toast 通知的对象。

属性
OverloadAttribute

注解

由 applicationId 标识的应用必须与调用方属于同一个包。

如果你的应用使用后台 Internet 语音协议 (VOIP) 代理，请使用此方法的此形式，以指定在这种情况下显示 Toast 所需的应用 ID。

从桌面应用发送 Toast 通知

通常，从桌面应用发送 Toast 通知与从 UWP 应用发送 Toast 通知相同。 但是，应注意以下差异和要求：

  • 要使桌面应用显示 Toast，应用必须在“开始”屏幕上具有快捷方式。
  • 快捷方式必须具有 AppUserModelID。
  • 桌面应用无法计划 Toast。

有关详细信息，请参阅以下主题：

另请参阅

适用于