Aracılığıyla paylaş

Toast headers

Bildirimlerinizde bir bildirim üst bilgisi kullanarak İşlem Merkezi'nin içinde bir dizi ilgili bildirimi görsel olarak gruplandırabilirsiniz.

Important

Masaüstü Yaratıcılar Güncellemesi ve Bildirimler kitaplığının 1.4.0 sürümügerektirir: Toast başlıklarını görmek için sürüm 15063 veya üzerini çalıştırıyor olmanız gerekir. Bildiriminizin içeriğinde başlığı oluşturmak için UWP Community Toolkit Notifications NuGet kitaplığının 1.4.0 veya sonraki bir sürümünü kullanmanız gerekir. Üst bilgiler yalnızca Masaüstünde desteklenir.

Aşağıda görüldüğü gibi, bu grup konuşması tek bir başlık altında birleştirilir: "Kamp!!". Konuşmadaki her bir ileti, aynı bildirim başlığını paylaşan ayrı bir uyarı bildirimidir.

Başlık ile Toaslar

Ayrıca bildirimlerinizi uçuş anımsatıcıları, paket izleme ve daha fazlası gibi kategorilere göre görsel olarak gruplandırmayı da seçebilirsiniz.

Bildirime bir üst bilgi ekleyin

Bir bildirim bildirimine üst bilgi eklemek için şöyle yapabilirsiniz.

Note

Üst bilgiler yalnızca Masaüstünde desteklenir. Üst bilgileri desteklemeyen cihazlar sadece üst bilgiyi yoksayar.

new ToastContentBuilder()
    .AddHeader("6289", "Camping!!", "action=openConversation&id=6289")
    .AddText("Anyone have a sleeping bag I can borrow?");

In summary...

  1. Üst Bilgi'yi ToastContent'e ekleyin
  2. Gerekli Kimliği, Başlığı, ve Bağımsız Değişkenleri özelliklerini atayın.
  3. Bildiriminizi gönderme (daha fazla bilgi edinin)
  4. Başka bir bildirimde Kimliği numaralı aynı başlığı kullanarak bildirimleri başlık altında birleştirin. Kimliği, bildirimlerin gruplandırılıp gruplandırılmayacağını belirlemek için kullanılan tek özelliktir; yani Başlık ve Argümanlar farklı olabilir. En son bildirimdeki Başlık ve Argümanlar kullanılır. Bu bildirim kaldırılırsa, Başlık ve Argümanlar sonraki en son bildiriye düşer.

Üst bilgiden etkinleştirmeyi işleme

Üst bilgiler kullanıcılar tarafından tıklanabilir, böylece kullanıcı üst bilginize tıklayarak uygulamanızdan daha fazla bilgi edinebilir.

Bu nedenle, uygulamalar üst bilgide, bildirimdeki başlatma bağımsız değişkenlerine benzer şekilde Bağımsız Değişkenleri sağlayabilir.

Etkinleştirme, normal bildirim etkinleştirmeile aynı şekilde işlenir. Başka bir deyişle, bu bağımsız değişkenleri OnActivated yönteminde App.xaml.cs aynı kullanıcı tostunuzun gövdesine veya bildiriminizdeki bir düğmeye tıkladığında yaptığınız gibi alabilirsiniz.

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle toast activation
    if (e is ToastNotificationActivatedEventArgs)
    {
        // Arguments specified from the header
        string arguments = (e as ToastNotificationActivatedEventArgs).Argument;
    }
}

Additional info

Başlık, bildirimleri görsel olarak ayırır ve gruplaştırır. Bir uygulamanın sahip olabileceği maksimum bildirim sayısı (20) ve bildirim listesinin ilk giren ilk çıkar davranışı hakkında başka hiçbir lojistiği değiştirmez.

Üst bilgiler içindeki bildirimlerin sırası aşağıdaki gibidir... Belirli bir uygulama için, ilk olarak uygulamadan en son bildirim (ve üst bilginin parçasıysa üst bilgi grubunun tamamı) görüntülenir.

Kimliği seçtiğiniz herhangi bir dize olabilir. ToastHeader'daki özelliklerin hiçbirinde uzunluk veya karakter kısıtlaması yoktur. Tek kısıtlama, TÜM XML bildirim içeriğinizin 5 KB'tan büyük olamayacağıdır.

Üst bilgi oluşturmak, "Daha fazlasını göster" düğmesi görünmeden önce İşlem Merkezi'nde gösterilen bildirim sayısını değiştirmez (bu sayı varsayılan olarak 3'tür ve bildirim için sistem Ayarları'ndaki her uygulama için kullanıcı tarafından yapılandırılabilir).

Aynı uygulama başlığına tıklanması gibi üst bilgi üzerine tıklanması da bu üst bilgideki bildirimleri temizlemez (uygulamanız ilgili bildirimleri temizlemek için bildirim API'lerini kullanmalıdır).

  • Last updated on