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