Delen via

Badgemeldingen voor Windows-apps

Een meldingsbadge geeft samenvattings- of statusgegevens over die specifiek zijn voor uw app. Ze kunnen numeriek (1-99) of een van een set door het systeem geleverde glyphs zijn. Voorbeelden van informatie die het beste via een badge wordt overgebracht, zijn de status van de netwerkverbinding in een online game, de gebruikersstatus in een berichten-app, het aantal ongelezen e-mailberichten in een e-mail-app en het aantal nieuwe berichten in een sociale media-app.

Meldingsbadges worden weergegeven op het taakbalkpictogram van uw app en in de rechterbenedenhoek van de begintegel, ongeacht of de app wordt uitgevoerd. Badges kunnen worden weergegeven op alle tegelformaten.

Note

U kunt uw eigen badgeafbeelding niet opgeven; alleen door het systeem geleverde badgeafbeeldingen kunnen worden gebruikt.

Numerieke badges

Value Badge XML
Een getal van 1 tot 99. Een waarde van 0 is gelijk aan de tekenwaarde ‘none’ en zal de badge wissen. Een numerieke badge kleiner dan 100. <badge value="1"/>
Een getal groter dan 99. Een numerieke badge groter dan 99. <badge value="100"/>

Glyph badges

In plaats van een getal kan een badge een van een niet-uitbreidbare set status-glyphs weergeven.

Status Glyph XML
none (Er wordt geen badge weergegeven.) <badge value="none"/>
activity Een symboolbadge die de status 'activiteit' aangeeft. <badge value="activity"/>
alarm Een symboolbadge die de status 'alarm' aangeeft. <badge value="alarm"/>
alert Een glyph-badge die de status 'waarschuwing' aangeeft. <badge value="alert"/>
attention Een symboolbadge die de status 'aandacht' aangeeft. <badge value="attention"/>
available Een symboolbadge die de status 'beschikbaar' aangeeft. <badge value="available"/>
away Een symboolbadge die de status 'afwezig' aangeeft. <badge value="away"/>
busy Een pictogram dat de status Bezet aangeeft. <badge value="busy"/>
error Een symboolbadge die de status 'fout' aangeeft. <badge value="error"/>
newMessage Een symboolbadge die de status 'newMessage' aangeeft. <badge value="newMessage"/>
paused Een symboolbadge die de status 'onderbroken' aangeeft. <badge value="paused"/>
playing Een symboolbadge die de status 'afspelen' aangeeft. <badge value="playing"/>
unavailable Een glyph-badge die de status 'niet beschikbaar' aangeeft. <badge value="unavailable"/>

Een badge maken

In deze voorbeelden ziet u hoe u een badge-update maakt.

Een numerieke badge maken

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

}

Een symboolbadge maken

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

}

Een badge wissen

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

De voorbeeldcode halen

  • voorbeeld van meldingen
    Laat zien hoe u livetegels maakt, badgeupdates verzendt en pop-upmeldingen weergeeft.
  • Last updated on