Brickmeddelanden för Windows-appar

Ett meddelandemärke förmedlar sammanfattnings- eller statusinformation som är specifik för din app. De kan vara numeriska (1–99) eller en av en uppsättning av systemspecifika glyfer. Exempel på information som bäst förmedlas via ett märke är nätverksanslutningsstatus i ett onlinespel, användarstatus i en meddelandeapp, antal olästa e-postmeddelanden i en e-postapp och antal nya inlägg i en app för sociala medier.

Meddelandeikoner visas på appens aktivitetsfältsikon och i det nedre högra hörnet av startpanelen, oavsett om appen körs. Märken kan visas på alla panelstorlekar.

Note

Du kan inte ange en egen märkesbild. endast systembaserade märkesbilder kan användas.

Numeriska märken

Value Badge XML
Ett tal från 1 till 99. Värdet 0 motsvarar glyphvärdet "none" och rensar märket. Ett numeriskt märke som är mindre än 100. <badge value="1"/>
Valfritt tal större än 99. Ett numeriskt märke större än 99. <badge value="100"/>

Glyph-märken

I stället för ett tal kan ett emblem visa en av en icke-utökningsbar uppsättning statusglypher.

Status Glyph XML
none (Inget märke visas.) <badge value="none"/>
activity Ett glyph-märke som anger statusen <badge value="activity"/>
alarm Ett glyph-märke som anger <badge value="alarm"/>
alert Ett glyph-märke som anger statusen <badge value="alert"/>
attention Ett glyph-märke som anger statusen <badge value="attention"/>
available Ett glyph-märke som anger statusen <badge value="available"/>
away Ett glyph-märke som anger statusen <badge value="away"/>
busy Ett glyph-märke som anger statusen <badge value="busy"/>
error Ett glyph-märke som anger statusen <badge value="error"/>
newMessage Ett glyph-märke som anger statusen <badge value="newMessage"/>
paused Ett glyph-märke som anger statusen <badge value="paused"/>
playing Ett glyph-märke som anger statusen <badge value="playing"/>
unavailable Ett glyph-märke som anger statusen <badge value="unavailable"/>

Skapa ett märke

De här exemplen visar hur du skapar en märkesuppdatering.

Skapa ett numeriskt märke

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

}

Skapa ett teckenmärke

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

}

Rensa ett märke

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

Hämta exempelkoden

  • Last updated on