Freigeben über

Abzeichenbenachrichtigungen für Windows-Apps

Ein Benachrichtigungsabzeichen zeigt Zusammenfassungs- oder Statusinformationen an, die spezifisch für Ihre App sind. Sie können eine Ziffer (1-99) oder eines der vom System bereitgestellten Glyphen sein. Beispiele für Informationen, die am besten über ein Badge vermittelt werden, sind der Status der Netzwerkverbindung in einem Onlinespiel, der Benutzerstatus in einer Messaging-App, die Anzahl ungelesener E-Mails in einer Mail-App und die 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. Abzeichen können auf allen Kachelgrößen angezeigt werden.

Note

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

Numerische Abzeichen

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

Glyph-Abzeichen

Anstelle einer Zahl kann ein Abzeichen eine nicht erweiterbare Menge von Statussymbolen anzeigen.

Status Glyph XML
none (Es wird kein Abzeichen angezeigt.) <badge value="none"/>
activity Ein Glyphensignal, das den Status <badge value="activity"/>
alarm Ein Glyphensignal, das den Status <badge value="alarm"/>
alert Ein Glyphensignal, das den Status <badge value="alert"/>
attention Ein Glyphensignal, das den Status <badge value="attention"/>
available Ein Glyphensignal, das den Status <badge value="available"/>
away Ein Glyphensignal, das den Status <badge value="away"/>
busy Ein Glyphensignal, das den Status <badge value="busy"/>
error Ein Glyphensignal, das den Status <badge value="error"/>
newMessage Ein Glyphensignal, das den Status <badge value="newMessage"/>
paused Ein Glyphensignal, das den Status <badge value="paused"/>
playing Ein Glyphenabzeichen, das den Status 'wird gespielt' angibt. <badge value="playing"/>
unavailable Ein Glyphensignal, das den Status <badge value="unavailable"/>

Erstellen eines Badges

Diese Beispiele zeigen Ihnen, wie Sie ein Badge-Update erstellen.

Ein numerisches Badge erstellen

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 Glyphenabzeichens

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

Holen Sie sich den Beispielcode

  • Last updated on