BadgeUpdater Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Notifications
Modifica

Aggiornamenti una sovrimpressione badge nel riquadro specifico a cui è associato l'updater.

public ref class BadgeUpdater sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class BadgeUpdater final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdater final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class BadgeUpdater
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeUpdater
Public NotInheritable Class BadgeUpdater
Ereditarietà
Object Platform::Object IInspectable BadgeUpdater
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio seguente mostra l'uso di Update per inviare un aggiornamento numerico della notifica al riquadro dell'app chiamante.

function sendBadgeNotification() {
    var Notifications = Windows.UI.Notifications;
    var badgeXml;
    var badgeAttributes;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
    badgeAttributes = badgeXml.getElementsByTagName("badge");
    badgeAttributes[0].setAttribute("value", "7");

    // Create a badge notification from the XML content.
    var badgeNotification = new Notifications.BadgeNotification(badgeXml);

    // Send the badge notification to the app's tile.
    Notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);
}

Commenti

Per ottenere un'istanza di questo oggetto, chiamare il metodo BadgeUpdateManager.CreateBadgeUpdaterForApplication o BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile .

Quando viene creato, BadgeUpdater è associato a un'app specifica o a un riquadro secondario, quindi i metodi di questa classe influiscono solo sul singolo riquadro a cui è associata l'istanza dell'oggetto.

Metodi

Clear()

Rimuove il badge dal riquadro a cui è associato l'updater.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)

Avvia una serie di aggiornamenti temporali per la notifica da una risorsa Web a cui è associato l'updater. Aggiornamenti iniziare a un'ora specificata. Si noti che solo le risorse Web (http/https) sono consentite in un aggiornamento periodico.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)

Inizia una serie di aggiornamenti a tempo per il badge da una risorsa Web a cui è associato l'updater, a partire immediatamente. Si noti che solo le risorse Web (http/https) sono consentite in un aggiornamento periodico.
StopPeriodicUpdate()

Annulla la serie corrente di aggiornamenti a tempo per la notifica a cui è associato l'updater.
Update(BadgeNotification)

Applica una modifica al glifo o al numero del badge.

Si applica a

Vedi anche