Notifiche badge per le app di Windows

  • Articolo
A tile with a numeric badge displaying the number 63 to indicate 63 unread mails.
Riquadro con una notifica numerica che visualizza
numero 63 per indicare 63 messaggi non letti.

Un badge di notifica fornisce un riepilogo o informazioni sullo stato specifici dell'app. Possono essere numerici (1-99) o uno di un set di glifi forniti dal sistema. Esempi di informazioni meglio trasmesse tramite una notifica includono lo stato della connessione di rete in un gioco online, lo stato utente in un'app di messaggistica, il numero di messaggi non letti in un'app di posta elettronica e il numero di nuovi post in un'app di social media.

Le notifiche vengono visualizzate sull'icona della barra delle applicazioni dell'app e nell'angolo in basso a destra del riquadro iniziale, indipendentemente dal fatto che l'app sia in esecuzione. Le notifiche possono essere visualizzate in tutte le dimensioni dei riquadri.

Nota

Non è possibile fornire un'immagine badge personalizzata; è possibile usare solo immagini badge fornite dal sistema.

Badge numerici

Valore Badge XML
Un numero compreso tra 1 e 99. Il valore 0 equivale al valore del glifo "none" e cancella il badge. A numeric badge less than 100. <badge value="1"/>
Qualsiasi numero maggiore di 99. A numeric badge greater than 99. <badge value="100"/>

Badge del glifo

Anziché un numero, un badge può visualizzare uno dei glifi di stato non estendibili.

Status Icona XML
Nessuno (Nessun badge visualizzato. <badge value="none"/>
activity <badge value="activity"/>
allarme <badge value="alarm"/>
avviso <badge value="alert"/>
attenzione <badge value="attention"/>
disponibile <badge value="available"/>
a lavorare <badge value="away"/>
occupato <badge value="busy"/>
Errore <badge value="error"/>
newMessage <badge value="newMessage"/>
in pausa <badge value="paused"/>
gioco attivo <badge value="playing"/>
non disponibile <badge value="unavailable"/>

Creare una notifica

Questi esempi illustrano come creare un aggiornamento badge.

Creare una notifica numerica

private void setBadgeNumber(int num)
{

    // Get the blank badge XML payload for a badge number
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);

    // Set the value of the badge in the XML to our number
    XmlElement badgeElement = badgeXml.SelectSingleNode("/badge") as XmlElement;
    badgeElement.SetAttribute("value", num.ToString());

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

Creare un badge per glifi

private void updateBadgeGlyph()
{
    string badgeGlyphValue = "alert";

    // Get the blank badge XML payload for a badge glyph
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);

    // Set the value of the badge in the XML to our glyph value
    Windows.Data.Xml.Dom.XmlElement badgeElement = 
        badgeXml.SelectSingleNode("/badge") as Windows.Data.Xml.Dom.XmlElement;
    badgeElement.SetAttribute("value", badgeGlyphValue);

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

Deselezionare un badge

private void clearBadge()
{
    BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();
}

Scaricare il codice di esempio

  • Esempio di notifica
    Illustra come creare riquadri animati, inviare aggiornamenti badge e visualizzare le notifiche di tipo avviso popup.