ToastNotificationManager Klasse

Referenz

Definition

Namespace:: Windows.UI.Notifications

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Erstellt ToastNotifier-Objekte , die Sie zum Auslösen von Popupbenachrichtigungen verwenden. Diese Klasse bietet auch Zugriff auf den XML-Inhalt der vom System bereitgestellten Popupvorlagen, sodass Sie diesen Inhalt für die Verwendung in Ihren Benachrichtigungen anpassen können.

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

Vererbung: Object Platform::Object IInspectable ToastNotificationManager

Attribute: ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Popupbenachrichtigung erstellen und senden, die Text und Bilder enthält, einschließlich der Verwendung der Methoden GetTemplateContent und 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);

Hinweise

Senden von Popupbenachrichtigungen von Desktop-Apps

Im Allgemeinen ist das Senden einer Popupbenachrichtigung von einer Desktop-App mit dem Senden von einer UWP-App identisch. Sie sollten jedoch die folgenden Unterschiede und Anforderungen kennen:

Damit eine Desktop-App ein Popup anzeigt, muss die App über eine Verknüpfung auf dem Startbildschirm verfügen.
Die Verknüpfung muss über eine AppUserModelID verfügen.
Desktop-Apps können kein Popup planen.

Weitere Informationen finden Sie in den folgenden Themen:

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	ConfigureNotificationMirroring
1607	14393	GetForUser
1703	15063	GetDefault

Eigenschaften

History

Ruft das ToastNotificationHistory-Objekt ab.

Methoden

ConfigureNotificationMirroring(NotificationMirroring)	Gibt an, ob die Benachrichtigungsspiegelung zulässig ist. Durch die Benachrichtigungsspiegelung kann eine Benachrichtigung auf mehreren Geräten übertragen werden.
CreateToastNotifier()	Erstellt und initialisiert eine neue instance der ToastNotification, die an die aufrufende Anwendung gebunden ist, mit der Sie eine Popupbenachrichtigung für diese App auslösen können.
CreateToastNotifier(String)	Erstellt und initialisiert eine neue instance der ToastNotification, die an eine angegebene App gebunden ist, in der Regel eine andere App im selben Paket.
GetDefault()	Ruft einen Popupbenachrichtigungs-Manager für den aktuellen Benutzer ab.
GetForUser(User)	Ruft einen Popupbenachrichtigungs-Manager für den angegebenen Benutzer ab.
GetTemplateContent(ToastTemplateType)	Ruft den XML-Inhalt einer der vordefinierten Popupvorlagen ab, damit Sie ihn für die Verwendung in Ihrer Benachrichtigung anpassen können.

Gilt für:

Freigeben über