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)	將內容或外觀的變更套用至磚。