Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Aşağıda, bildirim içeriğindeki tüm özellikler ve öğeler açıklanmaktadır.
Windows Uygulama SDK'sı oluşturucu API'leri yerine ham XML kullanmayı tercih ediyorsanız bkz. XML şeması.
ToastContent
ToastContent görseller, eylemler ve ses de dahil olmak üzere bildirimin içeriğini açıklayan en üst düzey nesnedir.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Launch | String | false | Toast bildirimi tarafından etkinleştirildiğinde uygulamaya geçirilen bir dize. Bu dizenin biçimi ve içeriği uygulama tarafından kendi kullanımı için tanımlanır. Kullanıcı ilişkili uygulamasını başlatmak için Bildirim'e dokunduğunda veya tıkladığında, başlatma dizesi uygulamaya varsayılan olarak başlatmak yerine kullanıcıya Bildirim içeriğiyle ilgili bir görünüm göstermesini sağlayan bağlamı sağlar. |
| Visual | ToastVisual | doğru | Uygulama bildiriminin görsel bölümünü açıklar. |
| Eylemler | IToastActions | false | İsteğe bağlı olarak düğmeler ve girişlerle özel eylemler oluşturun. |
| Audio | ToastAudio | false | Uygulama bildiriminin ses bölümünü açıklar. |
| ActivationType | ToastActivationType | false | Kullanıcı bu Toast Bildirimi gövdesine tıkladığında hangi etkinleştirme türünün kullanılacağını belirtir. |
| ActivationOptions | ToastActivationOptions | false | Uygulama bildiriminin etkinleştirilmesi ile ilgili ek seçenekler. |
| Senaryo | ToastScenario | false | Uyarı veya anımsatıcı gibi tostunuzun kullanıldığı senaryoyu bildirir. |
| DisplayTimestamp | DateTimeOffset? | false | Varsayılan zaman damgasını, bildirimin Windows platformu tarafından alındığı saat yerine bildirim içeriğinizin gerçekten teslim edildiği zamanı temsil eden özel bir zaman damgasıyla geçersiz kılın. |
| Header | ToastHeader | false | Bildirim Merkezi'nin içinde birden çok bildirimi birlikte gruplandırmak için bildiriminize özel bir üst bilgi ekleyin. |
ToastScenario
Bildirimin hangi senaryoyu temsil ettiği belirtir.
| Değer | Anlamı |
|---|---|
| Varsayılan | Normal tost davranışı. |
| Reminder | Anımsatıcı bildirimi. Bu, önceden genişletilmiş olarak görüntülenir ve kapatılana kadar kullanıcının ekranında kalır. |
| Alarm | Bir alarm bildirimi. Bu, önceden genişletilmiş olarak görüntülenir ve kapatılana kadar kullanıcının ekranında kalır. Ses varsayılan olarak döngüye girip alarm sesini kullanır. |
| IncomingCall | Gelen arama bildirimi. Bu, özel bir çağrı formatında önceden genişletilmiş olarak görüntülenir ve kapatılana kadar kullanıcının ekranında kalır. Ses varsayılan olarak döngü yapar ve zil sesi kullanır. |
ToastVisual
Bildirimlerin görsel bölümü metin, görüntü, uyarlamalı içerik ve daha fazlasını içeren bağlamaları içerir.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| BindingGeneric | ToastBindingGeneric | doğru | Tüm cihazlarda işlenebilen genel tost bağlaması. Bu bağlama gereklidir ve null olamaz. |
| BaseUri | Uri | false | Görüntü kaynağı özniteliklerindeki göreli URL'lerle birleştirilen varsayılan temel URL. |
| AddImageQuery | bool? | false | Windows uygulama bildiriminde sağlanan görüntü URL'sine bir sorgu dizesi eklemesine izin vermek için "true" olarak ayarlayın. Sunucunuz görüntüleri barındırıyorsa ve sorgu dizelerini işleyebiliyorsa, sorgu dizelerini temel alan bir görüntü değişkeni alarak veya sorgu dizesini yoksayarak ve sorgu dizesi olmadan belirtilen görüntüyü döndürerek bu özniteliği kullanın. Bu sorgu dizesi ölçek, karşıtlık ayarı ve dili belirtir; Örneğin, bildirimde verilen "www.website.com/images/hello.png" değeri "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" olur |
| Language | String | false | Yerelleştirilmiş kaynakları kullanırken, görsel yükün hedef yerel ayarı "en-US" veya "fr-FR" gibi BCP-47 dil etiketleri olarak belirtilir. Bu yerel ayar, bağlamada veya metinde belirtilen herhangi bir yerel ayar tarafından geçersiz kılınabilir. Sağlanmazsa, bunun yerine sistem yerel ayarı kullanılır. |
ToastBindingGeneric
Genel bağlama, bildirimler (toasts) için varsayılan bağlamadır ve metni, görüntüleri, uyarlanabilir içeriği ve daha fazlasını belirttiğiniz yerdir.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Çocuklar | IList<IToastBindingGenericChild> | false | Metin, resim ve grupları içerebilen Tost gövdesinin içeriği. Metin öğeleri diğer öğelerden önce gelmelidir ve yalnızca 3 metin öğesi desteklenir. Bir metin öğesi başka bir öğenin arkasına yerleştirilirse, en üste çekilir veya bırakılır. Son olarak, HintStyle gibi bazı metin özellikleri kök alt metin öğelerinde desteklenmez ve yalnızca AdaptiveSubgroup içinde çalışır. |
| AppLogoOverride | ToastGenericAppLogo | false | Uygulama logosunu geçersiz kılmak için isteğe bağlı bir logo. |
| HeroImage | ToastGenericHeroImage | false | Bildirimde ve Bildirim Merkezi'nde görüntülenen isteğe bağlı öne çıkan bir "hero" görseli. |
| Attribution | ToastGenericAttributionText | false | Uygulama bildiriminin en altında görüntülenecek isteğe bağlı ilişkilendirme metni. |
| BaseUri | Uri | false | Görüntü kaynağı özniteliklerindeki göreli URL'lerle birleştirilen varsayılan temel URL. |
| AddImageQuery | bool? | false | Windows uygulama bildiriminde sağlanan görüntü URL'sine bir sorgu dizesi eklemesine izin vermek için "true" olarak ayarlayın. Sunucunuz görüntüleri barındırıyorsa ve sorgu dizelerini işleyebiliyorsa, sorgu dizelerini temel alan bir görüntü değişkeni alarak veya sorgu dizesini yoksayarak ve sorgu dizesi olmadan belirtilen görüntüyü döndürerek bu özniteliği kullanın. Bu sorgu dizesi ölçek, karşıtlık ayarı ve dili belirtir; Örneğin, bildirimde verilen "www.website.com/images/hello.png" değeri "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" olur |
| Language | String | false | Yerelleştirilmiş kaynakları kullanırken, görsel yükün hedef yerel ayarı "en-US" veya "fr-FR" gibi BCP-47 dil etiketleri olarak belirtilir. Bu yerel ayar, bağlamada veya metinde belirtilen herhangi bir yerel ayar tarafından geçersiz kılınabilir. Sağlanmazsa, bunun yerine sistem yerel ayarı kullanılır. |
IToastBindingGenericChild
Metin, resim, grup ve daha fazlasını içeren tost alt öğeleri için işaretçi arabirimi.
| Uygulamalar |
|---|
| AdaptiveText |
| AdaptiveImage |
| AdaptiveGroup |
| AdaptiveProgressBar |
AdaptiveText
Uyarlamalı metin öğesi. Eğer ToastBindingGeneric.Children'in üst düzeyine yerleştirilirse, sadece HintMaxLines uygulanacaktır. Ancak bu, bir grup/alt grubun alt öğesi olarak yerleştirilirse, tam metin biçimlendirmesi desteklenir.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Metin | dize veya BindableString | false | Görüntülenecek metin. Veri bağlama yalnızca en üst düzey metin öğeleri için çalışır. |
| HintStyle | AdaptiveTextStyle | false | Stil, metnin yazı tipi boyutunu, kalınlığını ve opaklığını denetler. Yalnızca bir grup/alt grup içindeki metin öğeleri için çalışır. |
| HintWrap | bool? | false | Metin kaydırmayı etkinleştirmek için bunu "true" (doğru) olarak ayarlayın. Üst düzey metin öğeleri bu özelliği yoksayar ve her zaman sarmalar (en üst düzey metin öğeleri için kaydırmayı devre dışı bırakmak için HintMaxLines = 1 kullanabilirsiniz). Grupların/alt grupların içindeki metin öğeleri, kaydırma için varsayılan olarak false olarak ayarlanır. |
| HintMaxLines | int? | false | Metin öğesinin görüntülemesine izin verilen en fazla satır sayısı. |
| HintMinLines | int? | false | Metin öğesinin görüntülemesi gereken en az satır sayısı. Yalnızca bir grup/alt grup içindeki metin öğeleri için çalışır. |
| HintAlign | AdaptiveTextAlign | false | Metnin yatay hizalaması. Yalnızca bir grup/alt grup içindeki metin öğeleri için çalışır. |
| Language | String | false | "en-US" veya "fr-FR" gibi BCP-47 dil etiketleri olarak belirtilen XML yükünün hedef yerel ayarı. Burada belirtilen yerel ayar, bağlama veya görselde olduğu gibi belirtilen diğer tüm yerel ayarları geçersiz kılar. Bu değer değişmez bir dizeyse, bu öznitelik varsayılan olarak kullanıcının kullanıcı arabirimi diline ayarlanır. Eğer bu değer bir dize başvurusuysa, bu öznitelik varsayılan olarak dizeyi çözümlemekte Windows Çalışma Zamanı'ın seçtiği yerel ayar olur. |
BindableString
Dizeler için bağlama değeri.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| BindingName | String | doğru | Bağlama veri değerinizle eşleşen adı alır veya ayarlar. |
AdaptiveTextStyle
Metin stili yazı tipi boyutunu, kalınlığını ve opaklığını denetler. Hafif opaklık 60% opaktır.
| Değer | Anlamı |
|---|---|
| Varsayılan | Varsayılan değer. Stil işleyici tarafından belirlenir. |
| Başlık | Paragraf yazı tipi boyutundan daha küçük. |
| CaptionSubtle | Başlık ile aynı ama hafif bir opaklığa sahip. |
| Vücut | Paragraf yazı tipi boyutu. |
| BodySubtle | Gövde ile aynı ama hafif şeffaflık ile. |
| Base | Paragraf yazı tipi boyutu, kalın yazı tipi. Temelde Body'nin kalın sürümü. |
| BaseSubtle | Temel ile aynı ama hafif opaklık ile. |
| Subtitle | H4 yazı tipi boyutu. |
| SubtitleSubtle | Altyazı ile aynı ama hafif opaklık ile. |
| Başlık | H3 yazı tipi boyutu. |
| TitleSubtle | Başlık ile aynı ama daha hafif opaklıkta. |
| TitleNumeral | Başlıkla aynı ancak üst/alt dolgu kaldırıldı. |
| Subheader | H2 yazı tipi boyutu. |
| SubheaderSubtle | Alt Başlık ile aynı ama hafif opaklık var. |
| SubheaderNumeral | Alt Başlık ile aynı ama üst/alt dolgu kaldırılmış. |
| Header | H1 yazı tipi boyutu. |
| HeaderSubtle | Başlık ile aynı ama hafif opaklık var. |
| HeaderNumeral | Üst Bilgi ile aynı ama üst/alt dolgu kaldırıldı. |
AdaptiveTextAlign
Metnin yatay hizalamasını denetler.
| Değer | Anlamı |
|---|---|
| Varsayılan | Varsayılan değer. Hizalama, işleyici tarafından otomatik olarak belirlenir. |
| Otomatik | Geçerli dil ve kültür tarafından belirlenen hizalama. |
| Left | Metni yatay olarak sola hizalayın. |
| Center | Metni ortaya yatay olarak hizalayın. |
| Right | Metni yatay olarak sağa hizalayın. |
AdaptiveImage
Satır içi görüntü.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Kaynak | String | doğru | Görüntünün URL'si. ms-appx, ms-appdata ve http desteklenir. Web görüntüleri normal bağlantılarda 3 MB'a ve tarifeli bağlantılarda 1 MB'a kadar olabilir. |
| HintCrop | AdaptiveImageCrop | false | Görüntünün istenen kırpmasını denetleyin. |
| HintRemoveMargin | bool? | false | Varsayılan olarak, grupların/alt grupların içindeki görüntülerin çevresinde 8 piksel kenar boşluğu vardır. Bu özelliği true olarak ayarlayarak bu kenar boşluğunu kaldırabilirsiniz. |
| HintAlign | AdaptiveImageAlign | false | Görüntünün yatay hizalaması. Yalnızca bir grup/alt grup içindeki görüntüler için çalışır. |
| AlternateText | String | false | Erişilebilirlik amacıyla kullanılan görüntüyü açıklayan alternatif metin. |
| AddImageQuery | bool? | false | Windows uygulama bildiriminde sağlanan görüntü URL'sine bir sorgu dizesi eklemesine izin vermek için "true" olarak ayarlayın. Sunucunuz görüntüleri barındırıyorsa ve sorgu dizelerini işleyebiliyorsa, sorgu dizelerini temel alan bir görüntü değişkeni alarak veya sorgu dizesini yoksayarak ve sorgu dizesi olmadan belirtilen görüntüyü döndürerek bu özniteliği kullanın. Bu sorgu dizesi ölçek, karşıtlık ayarı ve dili belirtir; Örneğin, bildirimde verilen "www.website.com/images/hello.png" değeri "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" olur |
AdaptiveImageCrop
Görüntünün istenen kırpmasını belirtir.
| Değer | Anlamı |
|---|---|
| Varsayılan | Varsayılan değer. kırpma davranışı, oluşturucu tarafından belirlenir. |
| Hiçbiri | Görüntü kırpılmamış. |
| Circle | Resim daire şeklinde kırpılır. |
AdaptiveImageAlign
Görüntünün yatay hizalamasını belirtir.
| Değer | Anlamı |
|---|---|
| Varsayılan | Varsayılan değer. Hizalama davranışı, oluşturucu tarafından belirlenir. |
| Stretch | Görüntü, kullanılabilir genişliği (ve resmin konumuna bağlı olarak potansiyel olarak kullanılabilir yüksekliği) doldurmak için uzatılır. |
| Left | Görüntüyü yerel çözünürlüğünde görüntüleyerek sola hizalayın. |
| Center | Görüntüyü yerel çözünürlüğünde görüntüleyerek ortaya yatay olarak hizalayın. |
| Right | Görüntüyü sağa hizalayın ve görüntüyü yerel çözünürlüğünde görüntüleyin. |
AdaptiveGroup
Gruplar, içeriğin grupta bir bütün olarak görüntülenmesi gerektiğini veya yer bulamıyorsa görüntülenmemesi gerektiğini ifade eder. Gruplar ayrıca birden çok sütun oluşturmaya da izin verir.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Çocuklar | IList<UyarlanabilirAltGrup> | false | Alt gruplar dikey sütunlar olarak görüntülenir. AdaptiveGroup içinde herhangi bir içerik sağlamak için alt grupları kullanmanız gerekir. |
AdaptiveSubgroup
Alt gruplar, metin ve görüntü içerebilen dikey sütunlardır.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Çocuklar | IList<IAdaptiveSubgroupChild> | false | AdaptiveText ve AdaptiveImage alt grupların geçerli alt öğeleridir. |
| HintWeight | int? | false | Diğer alt gruplara göre ağırlığı belirterek bu alt grup sütununun genişliğini denetleyin. |
| HintTextStacking | AdaptiveSubgroupTextStacking | false | Bu alt grubun içeriğinin dikey hizalamasını denetleme. |
IAdaptiveSubgroupChild
Alt grup çocukları için işaretleyici arayüzü.
| Uygulamalar |
|---|
| AdaptiveText |
| AdaptiveImage |
AdaptiveSubgroupTextStacking
TextStacking, içeriğin dikey hizalamasını belirtir.
| Değer | Anlamı |
|---|---|
| Varsayılan | Varsayılan değer. oluşturucu varsayılan dikey hizalamayı otomatik olarak seçer. |
| Üst | Dikey olarak en üste hizalayın. |
| Center | Dikey ortaya hizalayın. |
| Bottom | Dikey olarak alta hizalayın. |
AdaptiveProgressBar
İlerleme çubuğu. Yalnızca Masaüstünde desteklenir.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Başlık | dize veya BindableString | false | İsteğe bağlı bir başlık metnini alır veya ayarlar. Veri bağlamayı destekler. |
| Değer | double veya AdaptiveProgressBarValue veya BindableProgressBarValue | false | İlerleme çubuğunun değerini alır veya ayarlar. Veri bağlamayı destekler. Varsayılan değer 0'dır. |
| ValueStringOverride | dize veya BindableString | false | Varsayılan yüzde dizesi yerine görüntülenecek isteğe bağlı bir dize alır veya ayarlar. Bu sağlanmamışsa , "70%" gibi bir şey görüntülenir. |
| Statü | dize veya BindableString | doğru | Soldaki ilerleme çubuğunun altında görüntülenen bir durum dizesini (gerekli) alır veya ayarlar. Bu dize işlemin durumunu yansıtmalıdır, örneğin "İndiriyor..." veya "Yükleniyor..." |
AdaptiveProgressBarValue
İlerleme çubuğunun değerini temsil eden bir sınıf.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Değer | iki katı | false | Tamamlanma yüzdesini temsil eden değeri (0,0 - 1,0) alır veya ayarlar. |
| IsIndeterminate | bool | false | İlerleme çubuğunun belirsiz olup olmadığını belirten bir değer alır veya ayarlar. Bu doğruysa, numaralı değer göz ardı edilecektir. |
BindableProgressBarValue
Bağlanabilir bir ilerleme çubuğu değeri.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| BindingName | String | doğru | Bağlama veri değerinizle eşleşen adı alır veya ayarlar. |
ToastGenericAppLogo
Uygulama logosu yerine görüntülenecek bir logo.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Kaynak | String | doğru | Görüntünün URL'si. ms-appx, ms-appdata ve http desteklenir. Http görüntülerinin boyutu 200 KB veya daha az olmalıdır. |
| HintCrop | ToastGenericAppLogoCrop | false | Resmin nasıl kırpılacağını belirtin. |
| AlternateText | String | false | Erişilebilirlik amacıyla kullanılan görüntüyü açıklayan alternatif metin. |
| AddImageQuery | bool? | false | Windows uygulama bildiriminde sağlanan görüntü URL'sine bir sorgu dizesi eklemesine izin vermek için "true" olarak ayarlayın. Sunucunuz görüntüleri barındırıyorsa ve sorgu dizelerini işleyebiliyorsa, sorgu dizelerini temel alan bir görüntü değişkeni alarak veya sorgu dizesini yoksayarak ve sorgu dizesi olmadan belirtilen görüntüyü döndürerek bu özniteliği kullanın. Bu sorgu dizesi ölçek, karşıtlık ayarı ve dili belirtir; Örneğin, bildirimde verilen "www.website.com/images/hello.png" değeri "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" olur |
ToastGenericAppLogoCrop
Uygulama logo görüntüsünün kırpınma işlemini denetler.
| Değer | Anlamı |
|---|---|
| Varsayılan | Kırpma, işleyicinin varsayılan davranışını kullanır. |
| Hiçbiri | Resim kırpılmaz, kare olarak görüntülenir. |
| Circle | Resim daire şeklinde kırpılır. |
ToastGenericHeroImage
Bildirim Merkezi'nin içinde ve bildirimde görüntülenen öne çıkan bir "hero" görüntüsü.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Kaynak | String | doğru | Görüntünün URL'si. ms-appx, ms-appdata ve http desteklenir. Http görüntülerinin boyutu 200 KB veya daha az olmalıdır. |
| AlternateText | String | false | Erişilebilirlik amacıyla kullanılan görüntüyü açıklayan alternatif metin. |
| AddImageQuery | bool? | false | Windows uygulama bildiriminde sağlanan görüntü URL'sine bir sorgu dizesi eklemesine izin vermek için "true" olarak ayarlayın. Sunucunuz görüntüleri barındırıyorsa ve sorgu dizelerini işleyebiliyorsa, sorgu dizelerini temel alan bir görüntü değişkeni alarak veya sorgu dizesini yoksayarak ve sorgu dizesi olmadan belirtilen görüntüyü döndürerek bu özniteliği kullanın. Bu sorgu dizesi ölçek, karşıtlık ayarı ve dili belirtir; Örneğin, bildirimde verilen "www.website.com/images/hello.png" değeri "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" olur |
ToastGenericAttributionText
Uygulama bildiriminin en altında görüntülenen ilişkilendirme metni.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Metin | String | doğru | Görüntülenecek metin. |
| Language | String | false | Yerelleştirilmiş kaynakları kullanırken, görsel yükün hedef yerel ayarı "en-US" veya "fr-FR" gibi BCP-47 dil etiketleri olarak belirtilir. Sağlanmazsa, bunun yerine sistem yerel ayarı kullanılır. |
IToastActions
Bildirim eylemleri/girişleri için işaretleyici arabirimi.
| Uygulamalar |
|---|
| ToastActionsCustom |
| ToastActionsSnoozeAndDismiss |
ToastActionsCustom
IToastActions'ı uygular
Düğmeler, metin kutuları ve seçim girişleri gibi denetimleri kullanarak kendi özel eylemlerinizi ve girişlerinizi oluşturun.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Giriş | IList<IToastInput> | false | Metin kutuları ve seçim girişleri gibi girişler. Yalnızca 5 girişe izin verilir. |
| Düğmeleri | IList<IToastButton> | false | Düğmeler tüm girişlerden sonra görüntülenir (veya düğme hızlı yanıt düğmesi olarak kullanılıyorsa girişe bitişiktir). Yalnızca en fazla 5 düğmeye (veya bağlam menüsü öğeleriniz varsa daha az) izin verilir. |
| ContextMenuItems | IList<ToastContextMenuItem> | false | Özel bağlam menüsü öğeleri, kullanıcı bildirime sağ tıklarsa ek eylemler sağlar. vebirleştirilmiş en fazla 5 düğme ve bağlam menüsü öğesi bulundurabilirsiniz. |
IToastInput
Mesaj bildirimleri için işaretleyici arabirimi.
| Uygulamalar |
|---|
| ToastTextBox |
| ToastSelectionBox |
ToastTextBox
IToastInput'u uygular
Kullanıcının metin yazabileceği bir metin kutusu denetimi.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| ID | String | doğru | ID gereklidir ve kullanıcı girişi metnini, uygulamanızın daha sonra kullandığı bir id/değer anahtar çiftiyle eşlemek için kullanılır. |
| Başlık | String | false | Metin kutusunun üzerinde görüntülenecek başlık metni. |
| PlaceholderContent | String | false | Kullanıcı henüz herhangi bir metin yazmadığında metin kutusunda görüntülenecek yer tutucu metin. |
| DefaultInput | String | false | Metin kutusuna yerleştirilecek ilk metin. Boş bir metin kutusu için bu null değerini bırakın. |
ToastSelectionBox
IToastInput'u uygular
Kullanıcıların seçenek açılan listesinden seçim yapmasını sağlayan seçim kutusu denetimi.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| ID | String | doğru | Kimlik gereklidir. Kullanıcı bu öğeyi seçtiyse, bu kimlik seçtiğiniz seçimi temsil eden uygulamanızın koduna geri geçirilir. |
| Content | String | doğru | İçerik gereklidir ve seçim öğesinde görüntülenen bir dizedir. |
ToastSelectionBoxItem
Seçim kutusu öğesi (kullanıcının açılan listeden seçebileceği bir öğe).
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| ID | String | doğru | ID gereklidir ve kullanıcı girişi metnini, uygulamanızın daha sonra kullandığı bir id/değer anahtar çiftiyle eşlemek için kullanılır. |
| Başlık | String | false | Seçim kutusunun üzerinde görüntülenecek başlık metni. |
| DefaultSelectionBoxItemId | String | false | Bu, varsayılan olarak hangi öğenin seçildiğini denetler ve ToastSelectionBoxItem id özelliğine başvurur. Bunu sağlamazsanız, varsayılan seçim boş olur (kullanıcı hiçbir şey görmez). |
| Items | IList<ToastSelectionBoxItem> | false | Kullanıcının bu Seçim Kutusu'nda seçebileceği seçim öğeleri. Yalnızca 5 öğe eklenebilir. |
IToastButton
Toast düğmeleri için işaretleyici arayüz.
| Uygulamalar |
|---|
| ToastButton |
| ToastButtonSnooze |
| ToastButtonDismiss |
ToastButton
IToastButton'ı uygular
Kullanıcının tıklayabileceği bir düğme.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Content | String | doğru | Gerekli. Düğmede görüntülenecek metin. |
| Arguments | String | doğru | Gerekli. Kullanıcı bu düğmeye tıklarsa uygulamanın daha sonra alacağı uygulama tanımlı bağımsız değişken dizesi. |
| ActivationType | ToastActivationType | false | Tıklandığında bu düğmenin ne tür bir etkinleştirme kullanacağını denetler. Varsayılan olarak Ön Plan olarak ayarlanır. |
| ActivationOptions | ToastActivationOptions | false | Bildirim düğmesinin etkinleştirilmesi ile ilgili ek seçenekleri alır veya ayarlar. |
ToastActivationType
Kullanıcı belirli bir eylemle etkileşime geçtiğinde kullanılacak etkinleştirme türüne karar verir.
| Değer | Anlamı |
|---|---|
| Foreground | Varsayılan değer. Ön plan uygulamanız başlatılır. |
| Background | İlgili arka plan göreviniz (her şeyi ayarladığınız varsayılarak) tetiklendiğinden, kullanıcıyı kesintiye uğratmadan arka planda kod yürütebilirsiniz (kullanıcının hızlı yanıt iletisini göndermek gibi). |
| Protokol | Protokol etkinleştirmeyi kullanarak farklı bir uygulama başlatın. |
ToastActivationOptions
Etkinleştirmeyle ilgili ek seçenekler.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| AfterActivationBehavior | ToastAfterActivationBehavior | false | Kullanıcının bu eylemi başlattığında toast bildiriminde kullanılacak davranışı alır veya ayarlar. Bu yalnızca Desktop'ta ToastButton ve ToastContextMenuItem için çalışır. |
| ProtocolActivationTargetApplicationPfn | String | false | ToastActivationType.Protocol kullanıyorsanız, isteğe bağlı olarak hedef PFN'yi belirtebilirsiniz; böylece aynı protokol uri'sini işlemek için birden çok uygulamanın kayıtlı olup olmadığına bakılmaksızın, istediğiniz uygulama her zaman başlatılır. |
ToastAfterActivationBehavior
Kullanıcı bildirim üzerinde işlem yaparken bildirimde kullanılacak davranışı belirtir.
| Değer | Anlamı |
|---|---|
| Varsayılan | Varsayılan davranış. Kullanıcı toast bildirimi üzerinde işlem yaptığında bildirim kapatılır. |
| PendingUpdate | Kullanıcı toast’unuzdaki bir düğmeye tıkladıktan sonra, bildirim, görsel olarak "bekleyen güncelleme" durumunda kalır. Kullanıcının bu "bekleyen güncelleştirme" görsel durumunu çok uzun süre görmemesi için, bir arka plan görevinden bildirimlerinizi anında güncelleştirmeniz gerekir. |
ToastButtonSnooze
IToastButton'ı uygular
Bildirimi otomatik olarak erteleyen sistem tarafından yönetilen bir erteleme düğmesi.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| CustomContent | String | false | Varsayılan yerelleştirilmiş "Ertele" metnini geçersiz kılan düğmede görüntülenen isteğe bağlı özel metin. |
ToastButtonDismiss
IToastButton'ı uygular
Tıklandığında bildirimi kapatan sistem tarafından yönetilen bir kapatma düğmesi.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| CustomContent | String | false | Varsayılan yerelleştirilmiş "Kapat" metnini geçersiz kılan düğmede görüntülenen isteğe bağlı özel metin. |
ToastActionsSnoozeAndDismiss
*IToastActions uygular
Erteleme aralıkları için otomatik olarak bir seçim kutusu ve erteleme/kapatma düğmeleri oluşturur, tümü otomatik olarak yerelleştirilir ve erteleme mantığı sistem tarafından otomatik olarak işlenir.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| ContextMenuItems | IList<ToastContextMenuItem> | false | Özel bağlam menüsü öğeleri, kullanıcı bildirime sağ tıklarsa ek eylemler sağlar. En fazla 5 öğeniz olabilir. |
ToastContextMenuItem
Bağlam menüsü öğesi girdisi.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Content | String | doğru | Gerekli. Görüntülenecek metin. |
| Arguments | String | doğru | Gerekli. Kullanıcı menü öğesine tıkladığında ve uygulama etkinleştirildiğinde, uygulamanın daha sonra alabileceği, uygulama tarafından tanımlanmış bağımsız değişkenler dizesi. |
| ActivationType | ToastActivationType | false | Bu menü öğesinin tıklandığında ne tür bir etkinleştirme kullanacağını denetler. Varsayılan olarak Ön Plan olarak ayarlanır. |
| ActivationOptions | ToastActivationOptions | false | Bildirim bağlamı menü öğesini etkinleştirmeyle ilgili ek seçenekler. |
ToastAudio
Uygulama bildirimi alındığında çalınacak sesi belirtin.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| Src | URI | false | Varsayılan ses yerine yürütülecek medya dosyası. Yalnızca ms-appx ve ms-resource desteklenir. Diğer tüm (ms-appdata, http, C:, vb.) desteklenmez. |
| Loop | Boolean | false | Tost gösterildiği sürece sesin yinelenmesi gerekiyorsa true olarak ayarlayın; false değerini yalnızca bir kez oynatmak için (varsayılan). |
| Sessiz | Boolean | false | Sesi kapatmak için "true"; uygulama bildirim sesinin çalmasına izin vermek için "false" (varsayılan). |
ToastHeader
Birden çok bildirimi Bildirim Merkezi içinde gruplandıran özel başlık.
| Mülkiyet | Türü | Zorunlu | Açıklama |
|---|---|---|---|
| ID | String | doğru | Geliştirici tarafından oluşturulan bu tanımlayıcı, bu üst bilgiyi benzersiz olarak tanımlar. İki bildirim aynı üst bilgi kimliğine sahipse, Bildirim Merkezi'nde aynı üst bilginin altında görüntülenir. |
| Başlık | String | doğru | Başlık için bir başlık. |
| Arguments | String | doğru | Kullanıcı bu başlık satırına tıkladığında uygulamaya geri döndürülen geliştirici tanımlı bağımsız değişken dizesini alır veya ayarlar. Null olamaz. |
| ActivationType | ToastActivationType | false | Tıklanırlığında bu başlığın kullanacağı etkinleştirme türünü alır veya ayarlar. Varsayılan olarak Ön Plan olarak ayarlanır. Yalnızca Ön Plan ve Protokolün desteklendiğini unutmayın. |
| ActivationOptions | ToastActivationOptions | false | Bildirim başlığının etkinleştirilmesi ile ilgili ek seçenekleri alır veya ayarlar. |
İlgili konular
Windows developer