Pemberitahuan lencana untuk aplikasi Windows

2025-06-10

Lencana pemberitahuan menyampaikan ringkasan atau informasi status khusus untuk aplikasi Anda. Mereka dapat berupa numerik (1-99) atau salah satu dari satu set glyph yang disediakan sistem. Contoh informasi yang paling baik disampaikan melalui lencana termasuk status koneksi jaringan dalam game online, status pengguna di aplikasi olahpesan, jumlah email yang belum dibaca di aplikasi email, dan jumlah posting baru di aplikasi media sosial.

Lencana pemberitahuan muncul di ikon taskbar aplikasi Anda dan di sudut kanan bawah petak peta mulainya, terlepas dari apakah aplikasi sedang berjalan. Lencana dapat ditampilkan pada semua ukuran petak peta.

Catatan

Anda tidak dapat memberikan gambar lencana Anda sendiri; hanya citra lencana yang disediakan sistem yang dapat digunakan.

Lencana numerik

Nilai	Lencana	XML
Angka dari 1 hingga 99. Nilai 0 setara dengan nilai glyph "none" dan akan menghapus lencana.		`<badge value="1"/>`
Angka apa pun yang lebih besar dari 99.		`<badge value="100"/>`

Lencana Glyph

Alih-alih angka, lencana dapat menampilkan salah satu dari serangkaian glyph status yang tidak dapat diperluas.

Kedudukan	Simbol	XML
tidak ada	(Tidak ada lencana yang ditampilkan.)	`<badge value="none"/>`
aktivitas		`<badge value="activity"/>`
Alarm		`<badge value="alarm"/>`
peringatan		`<badge value="alert"/>`
perhatian		`<badge value="attention"/>`
tersedia		`<badge value="available"/>`
tidak di tempat		`<badge value="away"/>`
Sibuk		`<badge value="busy"/>`
kesalahan		`<badge value="error"/>`
pesanBaru		`<badge value="newMessage"/>`
Berhenti		`<badge value="paused"/>`
Bermain		`<badge value="playing"/>`
tidak tersedia		`<badge value="unavailable"/>`

Membuat lencana

Contoh-contoh ini menunjukkan kepada Anda cara membuat pembaruan lencana.

Membuat lencana numerik

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

}

Membuat lencana glyph

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

}

Menghapus lencana

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

Mendapatkan kode sampel

Sampel pemberitahuan
Memperlihatkan cara membuat petak peta langsung, mengirim pembaruan lencana, dan menampilkan pemberitahuan toast.

Bagikan melalui