BadgeUpdateManager Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membuat objek BadgeUpdater yang Anda gunakan untuk memanipulasi overlay lencana petak peta. Kelas ini juga menyediakan akses ke konten XML dari templat lencana yang disediakan sistem sehingga Anda dapat menyesuaikan konten tersebut untuk digunakan dalam memperbarui lencana Anda.
public ref class BadgeUpdateManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class BadgeUpdateManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdateManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public static class BadgeUpdateManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class BadgeUpdateManager
Public Class BadgeUpdateManager
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Contoh berikut menunjukkan penggunaan GetTemplateContent untuk membuat konten untuk lencana numerik dan CreateBadgeUpdaterForApplication untuk mengirim pembaruan lencana numerik ke petak aplikasi panggilan.
function sendBadgeNotification() {
var Notifications = Windows.UI.Notifications;
var badgeXml;
var badgeAttributes;
// Get an XML DOM version of a specific template by using getTemplateContent.
badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "7");
// Create a badge notification from the XML content.
var badgeNotification = new Notifications.BadgeNotification(badgeXml);
// Send the badge notification to the app's tile.
Notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);
}
Keterangan
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1607 | 14393 | GetForUser |
Metode
CreateBadgeUpdaterForApplication() |
Membuat dan menginisialisasi instans baru BadgeUpdater, yang memungkinkan Anda mengubah tampilan atau konten lencana pada ubin aplikasi panggilan. |
CreateBadgeUpdaterForApplication(String) |
Membuat dan menginisialisasi instans baru BadgeUpdater untuk lencana petak peta aplikasi tertentu, biasanya petak peta aplikasi lain dalam paket. BadgeUpdater memungkinkan Anda mengubah tampilan atau konten lencana tersebut. |
CreateBadgeUpdaterForSecondaryTile(String) |
Membuat dan menginisialisasi instans baru BadgeUpdater, yang memungkinkan Anda mengubah tampilan atau konten lencana pada petak sekunder. Petak peta dapat menjadi milik aplikasi panggilan atau aplikasi lain dalam paket yang sama. |
GetForUser(User) |
Membuat dan menginisialisasi BadgeUpdateManagerForUser baru untuk pengguna yang ditentukan, yang memungkinkan Anda mengubah tampilan atau konten lencana pada petak peta untuk pengguna tertentu. |
GetTemplateContent(BadgeTemplateType) |
Mendapatkan konten XML dari salah satu templat lencana yang telah ditentukan sebelumnya sehingga Anda bisa menyesuaikannya untuk pembaruan lencana. |
Berlaku untuk
Lihat juga
- Sampel petak peta dan lencana aplikasi
- Panduan dan daftar periksa untuk petak dan lencana
- Cara menghapus lencana
- Cara mengirim lencana glyph atau numerik di pemberitahuan lokal
- Cara menyiapkan pemberitahuan berkala untuk lencana
- Cara memperbarui lencana melalui pemberitahuan push
- Skema XML lencana
- Gambaran umum lencana