TileUpdateManager 类

定义

命名空间:

Windows.UI.Notifications

创建用于更改和更新“开始”菜单磁贴的 TileUpdater 对象。 此类还提供对系统提供的磁贴模板的 XML 内容的访问权限，以便你可以自定义该内容以用于更新磁贴。

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

继承

Object Platform::Object IInspectable TileUpdateManager

属性

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

以下示例演示了用于检索磁贴模板的 XML 内容的 GetTemplateContent ，以及用于将通知发送到应用的磁贴的 CreateTileUpdaterForApplication 。

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);
}

注解

这是一个静态工厂类，不需要实例化。

版本历史记录

Windows 版本	SDK 版本	已添加值
1607	14393	GetForUser

方法

CreateTileUpdaterForApplication()	创建并初始化 TileUpdater 的新实例，这使你可以更改调用应用的磁贴的外观。
CreateTileUpdaterForApplication(String)	为 磁贴 创建并初始化磁贴的新实例，该磁贴属于与调用应用位于同一包中的另一个应用。 TileUpdater 允许开发人员更改该磁贴的外观。
CreateTileUpdaterForSecondaryTile(String)	创建并初始化 TileUpdater 的新实例，使你能够更改 辅助磁贴的外观。 磁贴可以属于调用应用或同一包中的任何其他应用。
GetForUser(User)	为指定用户创建并初始化新的 TileUpdateManagerForUser ，使你可以更改特定用户磁贴的外观或内容。
GetTemplateContent(TileTemplateType)	获取其中一个预定义磁贴模板的 XML 内容，以便可以自定义磁贴更新。 注意 在 Windows 8 系统上调用此方法时，它将返回 版本 1 模板。 在Windows 8.1系统上调用此方法时，它将返回版本 2 模板。 但是，如果应用在其清单中指定 Windows 8 兼容性，此方法将返回 版本 1 模板。

另请参阅

• 应用磁贴和锁屏提醒示例
• 快速入门：发送磁贴更新
• 磁贴和磁贴通知概述
• 磁贴模板目录
• 磁贴指南和清单
• 如何计划磁贴通知
• 如何为磁贴设置定期通知
• 磁贴 XML 架构