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)

Примеры

В следующем примере показано обновление , используемое для отправки уведомления на плитку приложения.

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)	Применяет к плитке изменение содержимого или внешнего вида.