Windows.UI.Notifications Namespace

Enthält Klassen, die Kachel-, Popup- und Signalbenachrichtigungen kapseln.

Klassen

AdaptiveNotificationText

Stellt den Textinhalt einer adaptiven Benachrichtigung dar.

BadgeNotification

Definiert den Inhalt, die zugeordneten Metadaten und die Ablaufzeit einer Aktualisierung der Badge-Überlagerung einer Kachel. Ein Badge kann eine Zahl von 1 bis 99 oder eine status Glyphe anzeigen.

BadgeUpdateManager

Erstellt BadgeUpdater-Objekte , die Sie zum Bearbeiten der Badge-Überlagerung einer Kachel verwenden. Diese Klasse bietet auch Zugriff auf den XML-Inhalt der vom System bereitgestellten Badgevorlagen, sodass Sie diese Inhalte für die Verwendung beim Aktualisieren Ihrer Badges anpassen können.

BadgeUpdateManagerForUser

Erstellt BadgeUpdater-Objekte , die Sie verwenden, um die Badge-Überlagerung einer Kachel für einen bestimmten Benutzer zu bearbeiten. Diese Klasse bietet auch Zugriff auf den XML-Inhalt der vom System bereitgestellten Badgevorlagen, sodass Sie diese Inhalte für die Verwendung beim Aktualisieren Ihrer Badges anpassen können.

BadgeUpdater

Updates eine Signalüberlagerung auf der bestimmten Kachel, an die der Updater gebunden ist.

KnownAdaptiveNotificationHints

Gibt die Arten von Hinweisen an, die für adaptive Benachrichtigungen verfügbar sind.

KnownAdaptiveNotificationTextStyles

Gibt die für adaptive Benachrichtigungen verfügbaren Textformate an.

KnownNotificationBindings

Gibt die für adaptive Benachrichtigungen verfügbaren Bindungsvorlagen an.

Notification

Stellt eine Benachrichtigung dar.

NotificationBinding

Stellt das Bindungselement einer adaptiven Benachrichtigung dar.

NotificationData

Speichert Daten für die Anzeige in einer Popupbenachrichtigung.

NotificationVisual

Stellt das visuelle Element einer Benachrichtigung dar. Das visuelle Element enthält Bindungen, die den Text und andere visuelle Inhalte für die Benachrichtigung enthalten.

ScheduledTileNotification

Definiert den visuellen Inhalt und das Timing für ein einzelnes, nicht wiederkehrendes geplantes Update auf einer Kachel.

ScheduledToastNotification

Enthält den XML-Code, der die Popupbenachrichtigung definiert, die zum geplanten Zeitpunkt angezeigt wird.

ScheduledToastNotificationShowingEventArgs

Stellt Informationen bereit, wenn das System gerade eine geplante Popupbenachrichtigung anzeigt.

ShownTileNotification

Stellt Informationen zu einer Kachelbenachrichtigung bereit, die im Startmenü angezeigt wurde.

TileFlyoutNotification

Stellt die Details einer Kachel-Flyoutbenachrichtigung (Mixansicht) bereit. Dies umfasst den XML-Inhalt der Benachrichtigung und optional die Ablaufzeit. Diese Klasse stellt auch eine Methode bereit, mit der Sie den XML-Inhalt der aktuellen Flyoutbenachrichtigung abrufen können.

Diese Klasse ist Teil des folgenden allgemeinen API-Nutzungsmusters:

TileFlyoutUpdateManager

Erstellt TileFlyoutUpdater-Objekte , die für die primäre oder sekundäre Kachel einer App spezifisch sind, für die Verwendung mit einer Kachelfliege (Mixansicht)-Benachrichtigung. Mit dieser Klasse können Sie auch eine leere Kachel-Flyout-XML-Vorlage abrufen, der Sie Ihren Inhalt hinzufügen können, um die Kachel-Flyoutbenachrichtigung zu definieren.

Diese Klasse ist Teil des folgenden allgemeinen API-Nutzungsmusters:

TileFlyoutUpdater

Wird verwendet, um eine Kachel-Flyoutbenachrichtigung (Mixansicht) zu senden oder zu löschen. Diese Klasse bietet auch Methoden zum Starten und Beenden regelmäßiger Kachel-Flyoutbenachrichtigungen.

Diese Klasse ist Teil des folgenden allgemeinen API-Nutzungsmusters:

TileNotification

Definiert ein Update für eine Kachel, einschließlich ihrer Visuellen Elemente, des Identifikationstags und der Ablaufzeit.

TileUpdateManager

Erstellt TileUpdater-Objekte, die zum Ändern und Aktualisieren von Startmenükacheln verwendet werden. Diese Klasse bietet auch Zugriff auf den XML-Inhalt der vom System bereitgestellten Kachelvorlagen, sodass Sie diesen Inhalt für die Verwendung beim Aktualisieren Ihrer Kacheln anpassen können.

TileUpdateManagerForUser

Erstellt TileUpdater-Objekte, die zum Ändern und Aktualisieren von Startmenükacheln für einen bestimmten Benutzer verwendet werden. Diese Klasse bietet auch Zugriff auf den XML-Inhalt der vom System bereitgestellten Kachelvorlagen, sodass Sie diesen Inhalt für die Verwendung beim Aktualisieren Ihrer Kacheln anpassen können.

TileUpdater

Ändert den Inhalt der bestimmten Kachel, an die der Updater gebunden ist.

ToastActivatedEventArgs

Macht eine Methode verfügbar, die die Argumente abruft, die einer vom Benutzer initiierten Popupaktion zugeordnet sind. Dadurch kann die App ermitteln, welche Aktion ausgeführt wurde, als mehrere Aktionen verfügbar gemacht wurden.

ToastCollection

Stellt eine Gruppe von Benachrichtigungen für eine bestimmte App dar.

ToastCollectionManager

Stellt Methoden zum Erstellen, Abrufen, Aktualisieren und Entfernen von ToastCollection-Objekten bereit.

ToastDismissedEventArgs

Gibt den Grund an, warum eine Popupbenachrichtigung nicht mehr auf dem Bildschirm angezeigt wird.

ToastFailedEventArgs

Stellt den Fehlercode bereit, der beim Auslösen einer Popupbenachrichtigung generiert wurde.

ToastNotification

Definiert den Inhalt, die zugeordneten Metadaten und Ereignisse sowie die Ablaufzeit einer Popupbenachrichtigung.

ToastNotificationActionTriggerDetail

Stellt die Details eines Popupaktionstriggers dar.

ToastNotificationHistory

Verwaltet die Popupbenachrichtigungen für eine App, einschließlich der Möglichkeit, den gesamten Popupverlauf zu löschen und einzelne Popups zu entfernen.

ToastNotificationHistoryChangedTriggerDetail

Stellt die Details eines geänderten Triggers für den Popupverlauf dar.

ToastNotificationManager

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.

ToastNotificationManagerForUser

Erstellt ToastNotifier-Objekte , die Sie zum Auslösen von Popupbenachrichtigungen für den gebundenen Benutzer 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.

ToastNotifier

Löst eine Popupbenachrichtigung für die bestimmte App aus, an die der ToastNotifier gebunden ist. Mit dieser Klasse können Sie auch Popupbenachrichtigungen planen und entfernen.

UserNotification

Stellt eine Benachrichtigung für einen bestimmten Benutzer dar.

UserNotificationChangedEventArgs

Stellt Informationen bereit, wenn sich eine Benutzerbenachrichtigung ändert.

Schnittstellen

IAdaptiveNotificationContent

Definiert den Inhalt für eine adaptive Benachrichtigung.

Enumerationen

AdaptiveNotificationContentKind

Gibt den Typ des Inhalts an, der in der adaptiven Benachrichtigung enthalten ist.

BadgeTemplateType

Gibt die Vorlage an, die für die Badgeüberlagerung einer Kachel verwendet werden soll. Wird von BadgeUpdateManager.getTemplateContent verwendet.

NotificationKinds

Gibt den Typ der Benachrichtigung an.

NotificationMirroring

Gibt an, ob die Benachrichtigungsspiegelung zulässig ist. Durch die Spiegelung kann eine Benachrichtigung auf mehreren Geräten angezeigt werden.

NotificationSetting

Gibt die Einschränkungen für die Anzeige von Kachel- oder Popupbenachrichtigungen an.

NotificationUpdateResult

Beschreibt die Ergebnisse eines Benachrichtigungsupdates.

PeriodicUpdateRecurrence

Gibt den Zeitraum für nachfolgende Abfragen der Kachel- oder Signaldatenquelle für neue Inhalte an. Wird von BadgeUpdater.StartPeriodicUpdate, TileUpdater.StartPeriodicUpdate und TileUpdater.StartPeriodicUpdateBatch verwendet.

TileFlyoutTemplateType

Gibt die Layoutvorlage an, die in einem Kachelflyoutupdate (Mixansicht) verwendet werden soll. Derzeit ist nur eine Vorlage definiert.

TileTemplateType

Gibt die Inhaltsvorlage an, die in einem Kachelupdate verwendet werden soll. Eine ausführlichere Erläuterung der einzelnen Kacheln, einschließlich eines Beispiels für die XML-Codierung, Der Spezifischen für die Bildgrößen jeder Vorlage und der Verwendung mit verschiedenen Versionen des KACHEL-XML-Schemas, finden Sie unter Der Kachelvorlagenkatalog.

Wenn auf einem Gerät angezeigt wird, das auf eine Sprache von rechts nach links (RTL) festgelegt ist, werden einige Vorlagen hier von ihren linken und rechten Beschreibungen gedreht.

In vielen Vorlagen wird die letzte Textzeile nicht angezeigt, wenn Ihre Kachel ein Logo oder einen Anzeigenamen enthält. Dies gilt nicht für die großen Kacheln (310 x 310). Weitere Informationen zum Logo/kurzen Namen finden Sie unter Schnellstart: Erstellen einer Standardkachel mit dem Manifest-Editor.

Wichtig

Windows 8.1 neue Vorlagen für große, quadratische Kacheln hinzugefügt. Um große Kacheln von mittleren Kacheln (in Windows 8 als quadratische Kacheln bezeichnet) zu unterscheiden, wurden alle älteren Vorlagen umbenannt. Um dies zu berücksichtigen, können Benachrichtigungsnutzlasten mit einer bestimmten Version deklariert werden. Aus Gründen der systemübergreifenden Kompatibilität wurde ein Fallback-Attribut hinzugefügt, sodass sowohl der alte Name als auch der neue Name vorhanden sind. Sie müssen die Unterschiede zwischen den Versionen verstehen, um sicherzustellen, dass Ihre Benachrichtigungen angezeigt werden. Weitere Informationen finden Sie unter Versionierte Vorlagen.

Wenn sie in Windows Phone 8.1 angezeigt werden, werden einige Vorlagen nicht ganz mit den unter Windows angezeigten Vorlagen angezeigt. Für instance, schauen Sie Vorlagen auf dem Telefon von vorne nach hinten, anstatt nach oben und unten zu scrollen. Die Anzahl der angezeigten Textzeilen kann unterschiedlich sein, manchmal weniger auf dem Telefon, aber in der Regel mehr. Breite Kachelbilder auf dem Telefon füllen die Kachel mit dem Text, der darauf überlagert ist, anstatt einen einfarbigen Textbereich zu haben. Bildsammlungskacheln sind animiert und sehen sehr unterschiedlich aus. Unterschiede, die Sie beachten müssen, werden für jeden Wert hervorgehoben.

ToastDismissalReason

Gibt den Grund an, warum eine Popupbenachrichtigung nicht mehr angezeigt wird. Wird mit ToastDismissedEventArgs.Reason verwendet.

ToastHistoryChangedType

Gibt die Art der Änderung an, die an einer Benachrichtigung im Popupverlauf aufgetreten ist. Wird mit ToastNotificationHistoryChangedTriggerDetail.ChangeType verwendet.

ToastNotificationMode

Enthält Klassen, die Kachel-, Popup- und Signalbenachrichtigungen kapseln.

ToastNotificationPriority

Gibt die Priorität einer ToastNotification an.

ToastTemplateType

Gibt die Vorlage an, die in einer Popupbenachrichtigung verwendet werden soll.

UserNotificationChangedKind

Gibt den Typ der Benutzerbenachrichtigungsänderung an, die aufgetreten ist.

Weitere Informationen