BadgeUpdateManager Classe

Definizione

Spazio dei nomi:

Windows.UI.Notifications

Crea oggetti BadgeUpdater usati per modificare la sovrapposizione di badge di un riquadro. Questa classe fornisce anche l'accesso al contenuto XML dei modelli di badge forniti dal sistema in modo che sia possibile personalizzare tale contenuto da usare per aggiornare i badge.

public ref class BadgeUpdateManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdateManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class BadgeUpdateManager

Public Class BadgeUpdateManager

Ereditarietà

Object Platform::Object IInspectable BadgeUpdateManager

Attributi

ContractVersionAttribute ThreadingAttribute 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

Nell'esempio seguente viene illustrato l'uso di GetTemplateContent per creare il contenuto per un badge numerico e CreateBadgeUpdaterForApplication per inviare un aggiornamento numerico 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

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	GetForUser

Metodi

CreateBadgeUpdaterForApplication()	Crea e inizializza una nuova istanza di BadgeUpdater, che consente di modificare l'aspetto o il contenuto del badge nel riquadro dell'app chiamante.
CreateBadgeUpdaterForApplication(String)	Crea e inizializza una nuova istanza di BadgeUpdater per il badge del riquadro dell'app specificato, in genere il riquadro di un'altra app nel pacchetto. BadgeUpdater consente di modificare l'aspetto o il contenuto di tale badge.
CreateBadgeUpdaterForSecondaryTile(String)	Crea e inizializza una nuova istanza di BadgeUpdater, che consente di modificare l'aspetto o il contenuto di un badge in un riquadro secondario. Il riquadro può appartenere all'app chiamante o a qualsiasi altra app nello stesso pacchetto.
GetForUser(User)	Crea e inizializza un nuovo BadgeUpdateManagerForUser per l'utente specificato, che consente di modificare l'aspetto o il contenuto del badge in un riquadro per un utente specifico.
GetTemplateContent(BadgeTemplateType)	Ottiene il contenuto XML di uno dei modelli di badge predefiniti in modo che sia possibile personalizzarlo per un aggiornamento di badge.

Vedi anche

• Esempio di riquadri e badge dell'app
• Linee guida ed elenco di controllo per i riquadri e le notifiche visuali
• Come cancellare un badge
• Come inviare un glifo o un badge numerico in una notifica locale
• Come configurare avvisi periodici per le notifiche
• Come aggiornare una notifica tramite notifiche push
• Schema XML badge
• Panoramica dei badge