TileUpdateManager Klasse

Definition

Namespace:

Windows.UI.Notifications

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.

public ref class TileUpdateManager abstract sealed

/// [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 TileUpdateManager final

[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 TileUpdateManager

Public Class TileUpdateManager

Vererbung

Object Platform::Object IInspectable TileUpdateManager

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 GetTemplateContent zum Abrufen des XML-Inhalts einer Kachelvorlage und CreateTileUpdaterForApplication , um die Benachrichtigung an die Kachel der App zu senden.

function sendTileTextNotification() {
    var Notifications = Windows.UI.Notifications;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWide310x150Text03);

    // You will need to look at the template documentation to know how many text fields a particular template has.
    // Get the text attribute for this template and fill it in.
    var tileAttributes = tileXml.getElementsByTagName("text");
    tileAttributes[0].appendChild(tileXml.createTextNode("Hello World!"));

    // Create the notification from the XML.
    var tileNotification = new Notifications.TileNotification(tileXml);

    // Send the notification to the calling app's tile.
    Notifications.TileUpdateManager.createTileUpdaterForApplication().update(tileNotification);
}

Hinweise

Dies ist eine statische Factoryklasse, die keine Instanziierung erfordert.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	GetForUser

Methoden

CreateTileUpdaterForApplication()	Erstellt und initialisiert eine neue instance von TileUpdater, mit der Sie die Darstellung der Kachel der aufrufenden App ändern können.
CreateTileUpdaterForApplication(String)	Erstellt und initialisiert eine neue instance des TileUpdater für eine Kachel, die zu einer anderen App im gleichen Paket gehört wie die aufrufende App. Mit Dem TileUpdater kann ein Entwickler das Erscheinungsbild dieser Kachel ändern.
CreateTileUpdaterForSecondaryTile(String)	Erstellt und initialisiert eine neue instance von TileUpdater, mit der Sie die Darstellung einer sekundären Kachel ändern können. Die Kachel kann zur aufrufenden App oder einer beliebigen anderen App im selben Paket gehören.
GetForUser(User)	Erstellt und initialisiert einen neuen TileUpdateManagerForUser für den angegebenen Benutzer, mit dem Sie die Darstellung oder den Inhalt einer Kachel für einen bestimmten Benutzer ändern können.
GetTemplateContent(TileTemplateType)	Ruft den XML-Inhalt einer der vordefinierten Kachelvorlagen ab, damit Sie ihn für eine Kachelaktualisierung anpassen können. Hinweis Wenn diese Methode auf einem Windows 8-System aufgerufen wird, wird eine Vorlage der Version 1 zurückgegeben. Wenn diese Methode auf einem Windows 8.1-System aufgerufen wird, wird eine Vorlage der Version 2 zurückgegeben. Wenn eine App jedoch windows 8-Kompatibilität in ihrem Manifest angibt, gibt diese Methode eine Vorlage der Version 1 zurück.

Weitere Informationen

• Beispiel für App-Kacheln und -Badges
• Schnellstart: Senden eines Kachelupdates
• Übersicht über Kachel- und Kachelbenachrichtigungen
• Der Kachelvorlagenkatalog
• Richtlinien und Prüfliste für Kacheln
• Planen einer Kachelbenachrichtigung
• So wird's gemacht: Einrichten regelmäßiger Benachrichtigungen für Kacheln
• XML-Schema für Kacheln