Signalbenachrichtigungen für Windows-Apps

  • Artikel

Ein Benachrichtigungssignal enthält eine Zusammenfassung oder Statusinformationen für Ihre App. Sie können numerisch (1-99) oder eine der vom System bereitgestellten Glyphen sein. Beispiele für Informationen, die am besten über ein Signal vermittelt werden, sind Netzwerkverbindungsstatus in einem Onlinespiel, Benutzerstatus in einer Messaging-App, Anzahl ungelesener E-Mails in einer Mail-App und Anzahl neuer Beiträge in einer Social Media-App.

Benachrichtigungssignale werden auf dem Taskleistensymbol Ihrer App und in der unteren rechten Ecke der Startkachel angezeigt, unabhängig davon, ob die App ausgeführt wird. Signale können auf allen Kachelgrößen angezeigt werden.

Hinweis

Sie können ihr eigenes Signalbild nicht bereitstellen; Nur vom System bereitgestellte Signalbilder können verwendet werden.

Numerische Signale

Wert Badge XML
Eine Zahl von 1 bis 99. Ein Wert von 0 entspricht dem Glyphenwert "none" und löscht das Signal. Ein numerisches Signal unter 100. <badge value="1"/>
Eine beliebige Zahl, die größer als 99 ist. Ein numerisches Signal, das größer als 99 ist. <badge value="100"/>

Glyphensignale

Anstelle einer Zahl kann ein Signal einen nicht erweiterbaren Satz von Statusglyphen anzeigen.

Status Glyphe XML
none (Es wird kein Signal angezeigt.) <badge value="none"/>
activity <badge value="activity"/>
Alarm <badge value="alarm"/>
Warnung <badge value="alert"/>
Aufmerksamkeit. <badge value="attention"/>
verfügbar <badge value="available"/>
weg <badge value="away"/>
busy <badge value="busy"/>
error <badge value="error"/>
newMessage <badge value="newMessage"/>
paused <badge value="paused"/>
Spielen <badge value="playing"/>
nicht verfügbar <badge value="unavailable"/>

Erstellen eines Badges

In diesen Beispielen wird gezeigt, wie Sie eine Signalaktualisierung erstellen.

Erstellen eines numerischen Badges

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);

}

Erstellen eines Glyphensignals

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);

}

Löschen eines Badges

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

Beispielcode herunterladen