Поделиться через


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

Комментарии

Чтобы получить экземпляр этого объекта, вызовите метод 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)

Применяет к плитке изменение содержимого или внешнего вида.

Применяется к