다음을 통해 공유


TileUpdater 클래스

정의

업데이트 프로그램의 바인딩된 특정 타일의 내용을 변경합니다.

public ref class TileUpdater sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TileUpdater final
/// [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)]
public sealed class TileUpdater
[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
특성

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에서 도입되었습니다.)

예제

다음 예제에서는 앱의 타일에 알림을 보내는 데 사용되는 업데이트를 보여줍니다.

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

설명

이 개체의 instance 얻으려면 TileUpdateManager.CreateTileUpdaterForApplication 또는 TileUpdateManager.CreateTileUpdaterForSecondaryTile 메서드를 호출합니다.

TileUpdater를 만들면 TileUpdater가 특정 앱 또는 보조 타일에 바인딩되므로 이 클래스의 메서드는 instance 개체가 바인딩된 단일 타일에만 영향을 줍니다.

속성

Setting

알림을 통해 타일을 업데이트할 수 있는지 여부를 지정하는 값을 가져옵니다.

메서드

AddToSchedule(ScheduledTileNotification)

ScheduledTileNotification을 일정에 추가합니다.

Clear()

모든 업데이트를 제거하고 타일이 앱의 매니페스트에 선언된 대로 기본 콘텐츠를 표시하도록 합니다.

EnableNotificationQueue(Boolean)

타일이 최대 5개의 알림을 큐에 대기할 수 있도록 합니다. 이렇게 하면 모든 타일 크기에서 알림 큐가 활성화됩니다.

EnableNotificationQueueForSquare150x150(Boolean)

타일이 중간 타일에서 최대 5개의 알림을 큐에 대기할 수 있도록 합니다.

EnableNotificationQueueForSquare310x310(Boolean)

타일이 큰 타일에서 최대 5개의 알림을 큐에 대기할 수 있도록 합니다.

EnableNotificationQueueForWide310x150(Boolean)

타일이 와이드 타일에서 최대 5개의 알림을 큐에 대기할 수 있도록 합니다.

GetScheduledTileNotifications()

타일에 대한 예약된 업데이트 목록을 검색합니다.

RemoveFromSchedule(ScheduledTileNotification)

일정에서 예정된 타일 업데이트를 제거합니다.

StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)

업데이트 프로그램의 바인딩된 타일에 대한 일련의 시간 제한 업데이트를 시작합니다. 업데이트 콘텐츠는 지정된 URI(Uniform Resource Identifier)에서 검색됩니다. 업데이트 지정된 시간에 시작됩니다.

StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)

업데이트 프로그램의 바인딩된 타일에 대한 일련의 시간 제한 콘텐츠 변경 내용을 즉시 시작합니다.

StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

업데이트 프로그램의 바인딩된 타일에서 순환하는 일련의 시간 제한 업데이트를 시작합니다. 업데이트 콘텐츠는 지정된 시간에 업데이트가 시작되고 이후 주기적 간격으로 후속 업데이트가 발생하는 지정된 URI(Uniform Resource Identifier) 배열에서 검색됩니다.

참고

이 기능을 사용하려면 먼저 EnableNotificationQueue를 호출하여 타일의 알림 큐를 사용하도록 설정해야 합니다.

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

업데이트 프로그램의 바인딩된 타일에서 순환하는 일련의 시간 제한 업데이트를 시작합니다. 업데이트 콘텐츠는 지정된 URI(Uniform Resource Identifier)의 배열에서 검색되며, 첫 번째 업데이트는 즉시 발생하고 이후 주기적인 간격으로 후속 업데이트가 발생합니다.

참고

이 기능을 사용하려면 먼저 EnableNotificationQueue를 호출하여 타일의 알림 큐를 사용하도록 설정해야 합니다.

StopPeriodicUpdate()

업데이트 프로그램의 바인딩된 타일에 대한 현재 일련의 시간 제한 업데이트를 취소합니다.

Update(TileNotification)

타일에 콘텐츠 또는 모양 변경을 적용합니다.

적용 대상