TileUpdater 类

定义

命名空间:

Windows.UI.Notifications

更改更新程序绑定到的特定磁贴的内容。

public ref class TileUpdater sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class TileUpdater final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class TileUpdater

Public NotInheritable Class TileUpdater

继承

Object Platform::Object IInspectable TileUpdater

属性

ContractVersionAttribute 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 中引入)

示例

以下示例显示了用于向应用磁贴发送通知的 Update 。

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

以下代码行使用 EnableNotificationQueue 为调用应用的磁贴启用通知队列。

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

以下示例演示如何使用 RemoveFromSchedule 方法。

var notifier = Notifications.TileUpdateManager.createTileUpdaterForApplication();
var scheduled = notifier.getScheduledTileNotifications();

for (var i = 0, len = scheduled.length; i < len; i++) {

    // The itemId value is the unique ScheduledTileNotification.Id assigned to the 
    // notification when it was created.
    if (scheduled[i].id === itemId) {
        notifier.removeFromSchedule(scheduled[i]);
    }
}

注解

若要获取此对象的实例，请调用 TileUpdateManager.CreateTileUpdaterForApplication 或 TileUpdateManager.CreateTileUpdaterForSecondaryTile 方法。

创建时，TileUpdater 将绑定到特定应用或辅助磁贴，因此此类的方法仅影响对象实例绑定到的单个磁贴。

属性

Setting

获取一个值，该值指定是否可以通过通知更新磁贴。

方法

AddToSchedule(ScheduledTileNotification)	将 ScheduledTileNotification 添加到计划。
Clear()	删除所有更新，并使磁贴显示应用清单中声明的默认内容。
EnableNotificationQueue(Boolean)	使磁贴最多可以排队五个通知。 这将在所有磁贴大小上启用通知队列。
EnableNotificationQueueForSquare150x150(Boolean)	使磁贴在中等磁贴上最多排队五个通知。
EnableNotificationQueueForSquare310x310(Boolean)	允许磁贴在大型磁贴上最多排队五个通知。
EnableNotificationQueueForWide310x150(Boolean)	允许磁贴在宽磁贴上最多排队五个通知。
GetScheduledTileNotifications()	检索磁贴的计划更新列表。
RemoveFromSchedule(ScheduledTileNotification)	从计划中删除即将进行的磁贴更新。
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	开始更新程序绑定到的磁贴的一系列定时更新。 从指定的统一资源标识符 (URI) 检索更新内容。 汇报从指定时间开始。
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	开始更新程序绑定到的磁贴的一系列计时内容更改，立即开始。
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)	开始在更新程序绑定到的磁贴上循环的一系列计时更新。 更新内容是从指定的统一资源标识符数组 (URI) 检索的，更新从指定时间开始，然后定期间隔进行后续更新。 注意 若要使用此功能，必须先通过调用 EnableNotificationQueue 来启用磁贴的通知队列。
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)	开始在更新程序绑定到的磁贴上循环的一系列计时更新。 更新内容是从指定的统一资源标识符数组 (URI) 检索的，第一次更新立即发生，后续更新随后定期发生。 注意 若要使用此功能，必须先通过调用 EnableNotificationQueue 来启用磁贴的通知队列。
StopPeriodicUpdate()	取消更新程序绑定到的磁贴的当前计时更新系列。
Update(TileNotification)	将内容或外观的更改应用于磁贴。