Freigeben über


TileUpdateManager Klasse

Definition

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)]
class TileUpdateManager 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 TileUpdateManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public static class TileUpdateManager
[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

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.

Gilt für:

Weitere Informationen