Oznámení na odznacích pro aplikace Windows

Odznak upozornění poskytuje souhrnné informace nebo informace o stavu specifické pro vaší aplikaci. Můžou to být číselné (1–99) nebo jedna ze sady systémových glyfů. Mezi příklady informací, které se nejlépe předávají prostřednictvím odznáčku, patří stav připojení k síti v online hře, stav uživatele v aplikaci pro zasílání zpráv, počet nepřečtených e-mailů v poštovní aplikaci a počet nových příspěvků v aplikaci sociálních médií.

Oznámení se zobrazí na ikoně hlavního panelu vaší aplikace a v pravém dolním rohu úvodní dlaždice bez ohledu na to, jestli je aplikace spuštěná. Odznáčky se dají zobrazit na všech velikostech dlaždic.

Note

Nemůžete zadat vlastní odznáček; Lze použít pouze obrázky odznáček poskytované systémem.

Číselné odznáčky

Value Badge jazyk XML
Číslo od 1 do 99. Hodnota 0 je ekvivalentní hodnotě glyf "none" a vymaže odznáček. číselný odznáček menší než 100. <badge value="1"/>
Libovolné číslo větší než 99. Číselný odznáček větší než 99. <badge value="100"/>

Odznáčky Glyph

Místo čísla může odznáček zobrazit jednu z ne rozšiřitelných množiny stavových glyfů.

Status Glyph jazyk XML
none (Žádný odznáček nezobrazen.) <badge value="none"/>
aktivita Odznáček glyph označující stav <badge value="activity"/>
alarm Odznáček glyph označující stav <badge value="alarm"/>
oznámení Odznáček glyph označující stav upozornění. <badge value="alert"/>
attention Odznáček glyph označující stav <badge value="attention"/>
available Odznáček glyph označující stav <badge value="available"/>
away Odznáček symbolu označující stav „pryč“. <badge value="away"/>
busy Odznáček glyph označující stav zaneprázdnění. <badge value="busy"/>
chyba Odznáček glyph označující stav <badge value="error"/>
newMessage Odznáček glyph označující stav newMessage. <badge value="newMessage"/>
paused Odznáček glyph označující stav pozastaveno. <badge value="paused"/>
playing Odznáček glyph označující stav <badge value="playing"/>
unavailable Odznáček glyph označující stav <badge value="unavailable"/>

Vytvoření odznáček

Tyto příklady ukazují, jak vytvořit aktualizaci odznáček.

Vytvořte číselný odznak

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

}

Vytvořit symbolický odznáček

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

}

Vymazání odznaku

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

Získání ukázkového kódu