Jelvényértesítések Windows-alkalmazásokhoz

Az értesítési jelvények az alkalmazásra vonatkozó összefoglaló vagy állapotinformációkat közvetítik. Ezek lehetnek numerikusak (1-99), vagy a rendszer által biztosított karakterjelek valamelyike. A jelvényen keresztül legjobban közvetített információk közé tartozik a hálózati kapcsolat állapota egy online játékban, a felhasználói állapot egy üzenetkezelő alkalmazásban, az olvasatlan levelek száma egy levelezőalkalmazásban, valamint a közösségimédia-alkalmazások új bejegyzéseinek száma.

Az értesítési jelvények az alkalmazás tálcáján és a kezdő csempe jobb alsó sarkában jelennek meg, függetlenül attól, hogy az alkalmazás fut-e. A jelvények minden csempeméreten megjeleníthetők.

Note

Nem adhat meg saját jelvényképet; csak rendszer által biztosított jelvényképek használhatók.

Numerikus jelvények

Value Badge XML
1 és 99 közötti szám. A 0 érték egyenértékű a "none" karakterjel értékével, és törli a jelvényt. 100-nál kisebb numerikus jelvényt. <badge value="1"/>
Bármely 99-nél nagyobb szám. Létezik egy 99-nél nagyobb numerikus jelvény. <badge value="100"/>

Ikonjelvények

Szám helyett a jelvény egy nem bővíthető állapotjelkészlet egyikét is megjelenítheti.

Status Glyph XML
none (Nem jelenik meg jelvény.) <badge value="none"/>
tevékenység A <badge value="activity"/>
alarm Egy karakterjelvény, amely a riasztás állapotát jelöli. <badge value="alarm"/>
figyelmeztetés A <badge value="alert"/>
attention Egy karakterjelvény, amely a <badge value="attention"/>
available A <badge value="available"/>
away Egy karakterjelvény, amely a <badge value="away"/>
busy A <badge value="busy"/>
hiba Egy karakterjelvény, amely a <badge value="error"/>
newMessage A <badge value="newMessage"/>
paused A <badge value="paused"/>
playing Egy karakterjelvény, amely a <badge value="playing"/>
unavailable Egy karakterjelvény, amely a <badge value="unavailable"/>

Jelvény létrehozása

Ezek a példák bemutatják, hogyan hozhat létre jelvényfrissítést.

Numerikus jelvény létrehozása

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

}

Glyph-jelvény létrehozása

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

}

Jelvény törlése

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

A mintakód lekérése

  • Last updated on