BadgeUpdater Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Notifications

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Condividi tramite