Condividi tramite

Notifiche badge per le app di Windows

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 Distintivo XML
Un numero compreso tra 1 e 99. Il valore 0 equivale al valore del glifo "none" e cancella il badge. Notifica numerica minore di 100. <badge value="1"/>
Qualsiasi numero maggiore di 99. Notifica numerica maggiore di 99. <badge value="100"/>

Badge del glifo

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

stato Icona XML
Nessuno (Nessun badge visualizzato. <badge value="none"/>
attività Notifica del glifo che indica lo stato dell'attività. <badge value="activity"/>
allarme Notifica del glifo che indica lo stato di <badge value="alarm"/>
avviso Badge del glifo che indica lo stato di allerta. <badge value="alert"/>
attenzione Badge di glifo indicante lo stato di <badge value="attention"/>
disponibile Notifica del glifo che indica lo stato <badge value="available"/>
a lavorare Notifica del glifo che indica lo stato <badge value="away"/>
occupato Notifica del glifo che indica lo stato <badge value="busy"/>
Errore Notifica del glifo che indica lo stato di errore. <badge value="error"/>
nuovoMessaggio Distintivo a forma di glifo che denota lo stato <badge value="newMessage"/>
in pausa Notifica del glifo che indica lo stato <badge value="paused"/>
gioco attivo Distintivo glifo che indica lo stato di esecuzione. <badge value="playing"/>
non disponibile Notifica del glifo che indica lo stato <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.