ScheduledTileNotification Klasse

Definition

Namespace:

Windows.UI.Notifications

Definiert den visuellen Inhalt und das Timing für eine einzelne, nicht wiederkehrende geplante Aktualisierung einer Kachel.

public ref class ScheduledTileNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IScheduledTileNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ScheduledTileNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IScheduledTileNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ScheduledTileNotification

function ScheduledTileNotification(content, deliveryTime)

Public NotInheritable Class ScheduledTileNotification

Vererbung

Object Platform::Object IInspectable ScheduledTileNotification

Attribute

ActivatableAttribute 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 eine Kachel, die in einer Stunde angezeigt werden soll.

var Notifications = Windows.UI.Notifications;
var currentTime = new Date();
var seconds = 60;
var dueTime = new Date(currentTime.getTime() + seconds * 60 * 1000);
var idNumber = Math.floor(Math.random() * 100000000);  // Generates a unique ID number for the notification.

var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWide310x150Text09);

// Set up the wide tile text.
var tileTextAttributes = tileXml.getElementsByTagName("text");
tileTextAttributes[0].appendChild(tileXml.createTextNode("This is a scheduled notification"));
tileTextAttributes[1].appendChild(tileXml.createTextNode("Received: " + dueTime.toLocaleTimeString()));

// Set up the medium tile text.
var squareTileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileSquare150x150Text04);
var squareTileTextAttributes = squareTileXml.getElementsByTagName("text");
squareTileTextAttributes[0].appendChild(squareTileXml.createTextNode("This is a scheduled notification"));

// Include the medium tile in the notification.
var node = tileXml.importNode(squareTileXml.getElementsByTagName("binding").item(0), true);
tileXml.getElementsByTagName("visual").item(0).appendChild(node);

// Create the notification object.
var futureTile = new Notifications.ScheduledTileNotification(tileXml, dueTime);
futureTile.id = "Tile" + idNumber;

// Add to the schedule.
Notifications.TileUpdateManager.createTileUpdaterForApplication().addToSchedule(futureTile);

Konstruktoren

ScheduledTileNotification(XmlDocument, DateTime)

Erstellt und initialisiert eine neue instance des ScheduledTileNotification-Objekts zur Verwendung mit einem TileUpdater.

Eigenschaften

Content	Ruft die XML-Beschreibung des Inhalts der geplanten Kachelaktualisierung ab.
DeliveryTime	Ruft den Zeitpunkt ab, zu dem die Aktualisierung der Kachel geplant ist.
ExpirationTime	Ruft die Zeit ab, nach der die Kachelbenachrichtigung nicht mehr angezeigt werden soll, oder legt diese fest. Standardmäßig läuft eine Kachelbenachrichtigung nicht ab. Es empfiehlt sich, explizit eine Ablaufzeit festzulegen, um veraltete Inhalte zu vermeiden.
Id	Ruft die eindeutige ID ab, die zum Identifizieren der geplanten Kachel im Zeitplan verwendet wird, oder legt diese fest.
Tag	Ruft eine Zeichenfolge ab, die Windows verwenden kann, um zu verhindern, dass doppelte Benachrichtigungsinhalte in der Warteschlange angezeigt werden, oder legt diese fest.