Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Následující část popisuje všechny vlastnosti a prvky v obsahu oznámení.
Pokud byste raději místo rozhraní API pro tvůrce Windows App SDK použili nezpracovaný KÓD XML, přečtěte si prosím soubor XML.
ToastContent
ToastContent je objekt nejvyšší úrovně, který popisuje obsah oznámení, včetně vizuálů, akcí a zvuku.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Launch | řetězec | false | Řetězec, který se předá aplikaci při aktivaci oznámením. Formát a obsah tohoto řetězce jsou definovány aplikací pro vlastní použití. Když uživatel klepne nebo klikne na oznámení, aby spustil přidruženou aplikaci, řetězec spuštění poskytuje aplikaci kontext, který umožňuje aplikaci zobrazit uživateli pohled relevantní k obsahu oznámení, místo výchozího spuštění. |
| Vizuální | ToastVisual | pravda | Popisuje vizuální část oznámení aplikace. |
| Akce | IToastActions | false | Volitelně můžete vytvářet vlastní akce s tlačítky a vstupy. |
| Zvuk | ToastAudio | false | Popisuje zvukovou část oznámení aplikace. |
| ActivationType | ToastActivationType | false | Určuje, jaký typ aktivace bude použit, když uživatel klikne na tělo této informační zprávy. |
| ActivationOptions | ToastActivationOptions | false | Další možnosti týkající se aktivace oznámení aplikace |
| Scénář | ToastScenario | false | Deklaruje účel vašeho toast oznámení, například alarm nebo připomenutí. |
| DisplayTimestamp | DateTimeOffset? | false | Přepište výchozí časové razítko vlastním časovým razítkem představujícím, kdy byl obsah oznámení skutečně doručen, a nikoli časem přijetí oznámení platformou Windows. |
| záhlaví | ToastHeader | false | Přidáním vlastní hlavičky do oznámení seskupíte několik oznámení dohromady v Centru oznámení. |
ToastScenario
Určuje, jaký scénář představuje informační zpráva.
| Hodnota | Význam |
|---|---|
| Default | Normální chování informačních toastů. |
| Reminder | Upozornění na připomenutí. Zobrazí se předem rozbalené a zůstane na obrazovce uživatele, dokud nebude zavřeno. |
| Alarm | Upozornění na alarm. Zobrazí se předem rozbalené a zůstane na obrazovce uživatele, dokud nebude zavřeno. Zvuk se bude smyčkovat ve výchozím nastavení a použije zvuk alarmu. |
| IncomingCall | Oznámení o příchozím hovoru Zobrazí se předem otevřené ve speciálním formátu volání a zůstane na obrazovce uživatele, dokud nebude zavřeno. Zvuk bude ve výchozím nastavení přehráván opakovaně a bude používat vyzváněcí tón. |
ToastVisual
Vizuální část notifikací obsahuje vazby, které obsahují text, obrázky, adaptivní obsah a další.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| BindingGeneric | ToastBindingGeneric | pravda | Obecná vazba toastu, která se dá vykreslit na všech zařízeních. Tato vazba je povinná a nesmí mít hodnotu null. |
| BaseUri | Uri | false | Výchozí základní adresa URL, která se kombinuje s relativními adresami URL ve zdrojových atributech obrázku. |
| AddImageQuery | bool? | false | Nastavte na hodnotu true, aby Windows připojila řetězec dotazu k adrese URL obrázku zadané v oznámení aplikace. Tento atribut použijte, pokud váš server hostuje obrázky a dokáže zpracovat dotazové řetězce, a to buď načtením varianty obrázku na základě dotazového řetězce, nebo ignorováním dotazového řetězce a vrácením obrázku tak, jak je zadán, bez dotazového řetězce. Tento řetězec dotazu určuje měřítko, nastavení kontrastu a jazyk; Například hodnota "www.website.com/images/hello.png" uvedená v oznámení se změní na "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
| Jazyk | řetězec | false | Cílové národní prostředí vizuálního obsahu při použití lokalizovaných zdrojů, zadané jako jazykové značky BCP-47, například "en-US" nebo "fr-FR". Toto místní nastavení je přepsáno jakýmkoli místním nastavením zadaným ve vazbě nebo textu. Pokud není k dispozici, použije se místo toho národní prostředí systému. |
ToastBindingGeneric
Univerzální vazba je výchozí vazbou pro oznámení, kde určíte text, obrázky, adaptivní obsah a další.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Děti | IList<IToastBindingGenericChild> | false | Obsah těla Toastu, který může zahrnovat text, obrázky a skupiny. Textové prvky musí předcházet všem ostatním prvkům a podporují se pouze 3 textové prvky. Pokud je textový prvek umístěn za jakýmkoli jiným prvkem, bude buď přesunut na začátek, nebo vymazán. A nakonec některé vlastnosti textu, jako je HintStyle, nejsou podporovány u textových elementů na úrovni kořenového prvku a fungují pouze uvnitř adaptivní podskupiny. |
| AppLogoOverride | ToastGenericAppLogo | false | Volitelné logo pro nahrazení loga aplikace. |
| HeroImage | ToastGenericHeroImage | false | Volitelný doporučený obrázek "hero", který se zobrazuje na informačním toastu a v Centru oznámení. |
| Attribution | ToastGenericAttributionText | false | Volitelný text přiřazení, který se zobrazí v dolní části oznámení aplikace. |
| BaseUri | Uri | false | Výchozí základní adresa URL, která se kombinuje s relativními adresami URL ve zdrojových atributech obrázku. |
| AddImageQuery | bool? | false | Nastavte na hodnotu true, aby Windows připojila řetězec dotazu k adrese URL obrázku zadané v oznámení aplikace. Tento atribut použijte, pokud váš server hostuje obrázky a dokáže zpracovat dotazové řetězce, a to buď načtením varianty obrázku na základě dotazového řetězce, nebo ignorováním dotazového řetězce a vrácením obrázku tak, jak je zadán, bez dotazového řetězce. Tento řetězec dotazu určuje měřítko, nastavení kontrastu a jazyk; Například hodnota "www.website.com/images/hello.png" uvedená v oznámení se změní na "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
| Jazyk | řetězec | false | Cílové národní prostředí vizuálního obsahu při použití lokalizovaných zdrojů, zadané jako jazykové značky BCP-47, například "en-US" nebo "fr-FR". Toto místní nastavení je přepsáno jakýmkoli místním nastavením zadaným ve vazbě nebo textu. Pokud není k dispozici, použije se místo toho národní prostředí systému. |
IToastBindingGenericChild
Rozlišovací rozhraní pro podřízené prvky, které obsahují text, obrázky, skupiny a další.
| Implementace |
|---|
| AdaptiveText |
| AdaptiveImage |
| AdaptiveGroup |
| AdaptiveProgressBar |
AdaptiveText
Adaptivní textový prvek. Pokud je umístěna na nejvyšší úrovni ToastBindingGeneric.Children, použije se pouze HintMaxLines. Pokud je však tato položka umístěna jako dítě skupiny nebo podskupiny, podporuje se úplné naformátování textu.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Text | řetězec nebo BindableString | false | Text k zobrazení Datové vazby fungují jenom u textových prvků nejvyšší úrovně. |
| HintStyle | AdaptiveTextStyle | false | Styl určuje velikost písma, tloušťku a neprůhlednost textu. Funguje jenom pro textové prvky uvnitř skupiny nebo podskupiny. |
| HintWrap | bool? | false | Pokud chcete povolit obtékání textu, nastavte tuto hodnotu na true. Textové prvky nejvyšší úrovně tuto vlastnost ignorují a vždy zalamují (k zakázání obtékání textových prvků nejvyšší úrovně můžete použít HintMaxLines = 1). Textové prvky uvnitř skupin nebo podskupin mají výchozí hodnotu false pro zabalení. |
| HintMaxLines | int? | false | Maximální počet řádků, které textový prvek může zobrazit. |
| HintMinLines | int? | false | Minimální počet řádků, které musí textový prvek zobrazit. Funguje jenom pro textové prvky uvnitř skupiny nebo podskupiny. |
| HintAlign | AdaptiveTextAlign | false | Vodorovné zarovnání textu Funguje jenom pro textové prvky uvnitř skupiny nebo podskupiny. |
| Jazyk | řetězec | false | Cílové národní prostředí datové části XML určené jako značky jazyka BCP-47, například "en-US" nebo "fr-FR". Zadané národní prostředí přepíše jakékoli jiné zadané národní prostředí, například národní prostředí ve vazbě nebo vizuálu. Pokud je tato hodnota literálový řetězec, tento atribut se ve výchozím nastavení nastaví do jazyka uživatelského rozhraní uživatele. Pokud je tato hodnota odkazem na řetězec, tento atribut se nastaví na místní nastavení, které zvolil prostředí Windows Runtime při řešení řetězce. |
BindableString
Vazební hodnota pro řetězce.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| BindingName | řetězec | pravda | Získá nebo nastaví název, který mapuje na hodnotu vazby. |
AdaptiveTextStyle
Styl textu určuje velikost písma, tloušťku a neprůhlednost. Jemná neprůhlednost je 60 % a barva% je neprůhledná.
| Hodnota | Význam |
|---|---|
| Default | Výchozí hodnota. Styl je určen rendererem. |
| Titulek | Menší než velikost písma odstavce |
| CaptionSubtle | Stejné jako titulek, ale s jemnou průhledností. |
| Tělo | Velikost písma odstavce |
| BodySubtle | Stejné jako tělo, ale s jemnou neprůhledností. |
| Base | Velikost písma odstavce, tučné písmo. V podstatě tučná verze Body. |
| BaseSubtle | Stejné jako základ, ale s jemnou průhledností. |
| Subtitle | Velikost písma H4 |
| SubtitleSubtle | Stejné jako podnadpis, ale s jemnou neprůhledností. |
| Titul | Velikost písma H3 |
| TitleSubtle | Stejné jako název, ale s jemnou průhledností. |
| TitleNumeral | Stejné jako nadpis, ale s odstraněným horním a dolním odsazením. |
| Subheader | Velikost písma H2 |
| SubheaderSubtle | Stejné jako podnadpis, ale s jemnou neprůhledností. |
| SubheaderNumeral | Stejné jako podnadpis, ale bez vnitřního okraje nahoře/dole. |
| záhlaví | Velikost písma H1 |
| HeaderSubtle | Stejné jako záhlaví, ale s jemnou průsvitností. |
| HeaderNumeral | Stejné jako záhlaví, ale s odstraněným horním a spodním odsazením. |
AdaptiveTextAlign
Určuje vodorovné zarovnání textu.
| Hodnota | Význam |
|---|---|
| Default | Výchozí hodnota. Zarovnání je automaticky určeno vykreslovacím modulem. |
| Automatické | Zarovnání určené aktuálním jazykem a kulturním prostředím |
| Left | Vodorovně zarovnejte text doleva. |
| Center | Vodorovně zarovnejte text ve středu. |
| Right | Vodorovně zarovnejte text doprava. |
AdaptiveImage
Vložený obrázek.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Zdroj | řetězec | pravda | Adresa URL obrázku. Podporují se ms-appx, ms-appdata a http. Webové obrázky můžou být až 3 MB při normálních připojeních a 1 MB u připojení účtovaných podle měr. |
| HintCrop | AdaptiveImageCrop | false | Určete požadované oříznutí obrázku. |
| HintRemoveMargin | bool? | false | Ve výchozím nastavení mají obrázky uvnitř skupin nebo podskupin kolem nich 8px okraj. Tento okraj můžete odebrat nastavením této vlastnosti na true. |
| HintAlign | AdaptiveImageAlign | false | Vodorovné zarovnání obrázku Funguje jenom pro obrázky uvnitř skupiny nebo podskupiny. |
| AlternateText | řetězec | false | Alternativní text popisující obrázek, který se používá pro účely přístupnosti. |
| AddImageQuery | bool? | false | Nastavte na hodnotu true, aby Windows připojila řetězec dotazu k adrese URL obrázku zadané v oznámení aplikace. Tento atribut použijte, pokud váš server hostuje obrázky a dokáže zpracovat dotazové řetězce, a to buď načtením varianty obrázku na základě dotazového řetězce, nebo ignorováním dotazového řetězce a vrácením obrázku tak, jak je zadán, bez dotazového řetězce. Tento řetězec dotazu určuje měřítko, nastavení kontrastu a jazyk; Například hodnota "www.website.com/images/hello.png" uvedená v oznámení se změní na "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
AdaptiveImageCrop
Určuje požadované oříznutí obrázku.
| Hodnota | Význam |
|---|---|
| Default | Výchozí hodnota. Chování oříznutí je určeno rendererem |
| Nic | Obrázek není oříznut. |
| Circle | Obrázek je oříznut do kruhového tvaru. |
AdaptiveImageAlign
Určuje vodorovné zarovnání obrázku.
| Hodnota | Význam |
|---|---|
| Default | Výchozí hodnota. Chování zarovnání určené vykreslovacím modulem |
| Stretch | Obrázek se roztáhne tak, aby vyplnil dostupnou šířku (a potenciálně dostupnou výšku také v závislosti na umístění obrázku). |
| Left | Zarovnejte obrázek doleva a zobrazte ho v nativním rozlišení. |
| Center | Zarovnejte obrázek ve středu vodorovně a zobrazte ho v nativním rozlišení. |
| Right | Zarovnejte obrázek doprava a zobrazte ho v nativním rozlišení. |
AdaptiveGroup
Skupiny sémanticky identifikují, že obsah ve skupině musí být buď zobrazen jako celek, nebo nesmí být zobrazen, pokud se nevejde. Skupiny také umožňují vytvářet více sloupců.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Děti | IList<AdaptiveSubgroup> | false | Podskupiny se zobrazují jako svislé sloupce. K poskytnutí veškerého obsahu uvnitř adaptivní skupiny musíte použít podskupiny. |
AdaptiveSubgroup
Podskupiny jsou svislé sloupce, které můžou obsahovat text a obrázky.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Děti | IList<IAdaptiveSubgroupChild> | false | AdaptiveText a AdaptiveImage jsou platnými položkami podskupin. |
| HintWeight | int? | false | Šířku tohoto sloupce podskupiny můžete řídit zadáním váhy vzhledem k ostatním podskupinám. |
| HintTextStacking | AdaptiveSubgroupTextStacking | false | Ovládejte svislé zarovnání obsahu této podskupiny. |
IAdaptiveSubgroupChild
Značkovací rozhraní pro potomky podskupin
| Implementace |
|---|
| AdaptiveText |
| AdaptiveImage |
AdaptiveSubgroupTextStacking
TextStacking určuje svislé zarovnání obsahu.
| Hodnota | Význam |
|---|---|
| Default | Výchozí hodnota. Renderer automaticky vybere výchozí svislé zarovnání. |
| Nejlepší | Svislé zarovnání k horní části |
| Center | Svislé zarovnání ke středu. |
| Bottom | Svislé zarovnání dolů. |
AdaptiveProgressBar
Indikátor průběhu. Podporuje se jenom v Desktopu.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Titul | řetězec nebo BindableString | false | Získá nebo nastaví řetězec pro volitelný název. Podporuje datové vazby. |
| Value | double nebo AdaptiveProgressBarValue nebo BindableProgressBarValue | false | Získá nebo nastaví hodnotu indikátoru průběhu. Podporuje datové vazby. Výchozí nastavení je 0. |
| ValueStringOverride | řetězec nebo BindableString | false | Získá nebo nastaví volitelný řetězec, který se zobrazí místo výchozího procentuálního řetězce. Pokud není zadaný, zobrazí se něco jako 70%. |
| Stav | řetězec nebo BindableString | pravda | Získá nebo nastaví stavový řetězec (povinné), který se zobrazí pod indikátorem průběhu na levé straně. Tento řetězec by měl odrážet stav operace, například "Stahování..." nebo "Probíhá instalace..." |
AdaptiveProgressBarValue
Třída, která představuje hodnotu indikátoru průběhu.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Value | dvojitý | false | Získá nebo nastaví hodnotu (0,0 – 1,0), která představuje procento dokončení. |
| IsIndeterminate | Booleova hodnota | false | Získá nebo nastaví hodnotu určující, zda je indikátor průběhu neurčitý. Pokud je to pravda, hodnota bude ignorována. |
BindableProgressBarValue
Hodnota pruhu průběhu s možností vazby.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| BindingName | řetězec | pravda | Získá nebo nastaví název, který mapuje na hodnotu vazby. |
ToastGenericAppLogo
Místo loga aplikace se zobrazí logo.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Zdroj | řetězec | pravda | Adresa URL obrázku. Podporují se ms-appx, ms-appdata a http. Obrázky HTTP musí mít velikost 200 kB nebo menší. |
| HintCrop | ToastGenericAppLogoCrop | false | Určete, jak se má obrázek oříznout. |
| AlternateText | řetězec | false | Alternativní text popisující obrázek, který se používá pro účely přístupnosti. |
| AddImageQuery | bool? | false | Nastavte na hodnotu true, aby Windows připojila řetězec dotazu k adrese URL obrázku zadané v oznámení aplikace. Tento atribut použijte, pokud váš server hostuje obrázky a dokáže zpracovat dotazové řetězce, a to buď načtením varianty obrázku na základě dotazového řetězce, nebo ignorováním dotazového řetězce a vrácením obrázku tak, jak je zadán, bez dotazového řetězce. Tento řetězec dotazu určuje měřítko, nastavení kontrastu a jazyk; Například hodnota "www.website.com/images/hello.png" uvedená v oznámení se změní na "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
ToastGenericAppLogoCrop
Řídí oříznutí obrázku loga aplikace.
| Hodnota | Význam |
|---|---|
| Default | Výchozí chování rendereru se používá při ořezávání. |
| Nic | Obrázek není oříznutý, je zobrazen ve čtvercovém formátu. |
| Circle | Obrázek se ořízne na kruh. |
ToastGenericHeroImage
Doporučený obrázek „hrdiny“, který se zobrazuje na toastu a v Centru oznámení.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Zdroj | řetězec | pravda | Adresa URL obrázku. Podporují se ms-appx, ms-appdata a http. Obrázky HTTP musí mít velikost 200 kB nebo menší. |
| AlternateText | řetězec | false | Alternativní text popisující obrázek, který se používá pro účely přístupnosti. |
| AddImageQuery | bool? | false | Nastavte na hodnotu true, aby Windows připojila řetězec dotazu k adrese URL obrázku zadané v oznámení aplikace. Tento atribut použijte, pokud váš server hostuje obrázky a dokáže zpracovat dotazové řetězce, a to buď načtením varianty obrázku na základě dotazového řetězce, nebo ignorováním dotazového řetězce a vrácením obrázku tak, jak je zadán, bez dotazového řetězce. Tento řetězec dotazu určuje měřítko, nastavení kontrastu a jazyk; Například hodnota "www.website.com/images/hello.png" uvedená v oznámení se změní na "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
ToastGenericAttributionText
Text přisuzování zobrazený v dolní části oznámení aplikace
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Text | řetězec | pravda | Text k zobrazení |
| Jazyk | řetězec | false | Cílové národní prostředí vizuálního obsahu při použití lokalizovaných zdrojů, zadané jako jazykové značky BCP-47, například "en-US" nebo "fr-FR". Pokud není k dispozici, použije se místo toho národní prostředí systému. |
IToastActions
Označovací rozhraní pro akce/vstupy toastů.
| Implementace |
|---|
| ToastActionsCustom |
| ToastActionsSnoozeAndDismiss |
ToastActionsCustom
Implementuje IToastActions.
Vytvořte vlastní akce a vstupy pomocí ovládacích prvků, jako jsou tlačítka, textová pole a vstupy výběru.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Vstupy | IList<IToastInput> | false | Vstupy, jako jsou textová pole a vstupy výběru. Jsou povoleny pouze 5 vstupů. |
| Tlačítka | IList<IToastButton> | false | Tlačítka se zobrazí po všech vstupech (nebo vedle vstupu, pokud se tlačítko použije jako tlačítko rychlé odpovědi). Jsou povolena pouze až 5 tlačítek (nebo méně tlačítek, pokud máte také položky místní nabídky). |
| ContextMenuItems | IList<ToastContextMenuItem> | false | Vlastní položky místní nabídky, které poskytují další akce, pokud uživatel klikne pravým tlačítkem myši na oznámení. Celkem můžete mít až 5 tlačítek a položek místní nabídky dohromady. |
IToastInput
Marker rozhraní pro vstupy toastů.
| Implementace |
|---|
| ToastTextBox |
| ToastSelectionBox |
ToastTextBox
Implementuje IToastInput.
Ovládací prvek textového pole, do kterého může uživatel zadat text.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Id | řetězec | pravda | Id je povinné a slouží k mapování uživatelem zadaného textu na dvojici ID a hodnoty klíč-hodnota, kterou vaše aplikace později využívá. |
| Titul | řetězec | false | Text nadpisu, který se zobrazí nad textovým polem. |
| PlaceholderContent | řetězec | false | Zástupný text, který se má zobrazit v textovém poli, když uživatel ještě nezadá žádný text. |
| DefaultInput | řetězec | false | Počáteční text, který se umístí do textového pole. Ponechte tuto hodnotu null pro prázdné textové pole. |
ToastSelectionBox
Implementuje IToastInput.
Ovládací prvek pole výběru, který umožňuje uživatelům vybírat z rozevíracího seznamu možností.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Id | řetězec | pravda | Id je povinné. Pokud uživatel vybral tuto položku, toto ID se předá zpět do kódu vaší aplikace, který představuje výběr, který zvolil. |
| Content | řetězec | pravda | Vyžaduje se obsah a je to řetězec, který se zobrazí u položky výběru. |
ToastSelectionBoxItem
Položka pole výběru (položka, kterou uživatel může vybrat z rozevíracího seznamu).
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Id | řetězec | pravda | Id je povinné a slouží k mapování uživatelem zadaného textu na dvojici ID a hodnoty klíč-hodnota, kterou vaše aplikace později využívá. |
| Titul | řetězec | false | Text nadpisu, který se zobrazí nad polem výběru |
| DefaultSelectionBoxItemId | řetězec | false | Tento prvek určuje, která položka je ve výchozím nastavení vybrána, a odkazuje na vlastnost Id ToastSelectionBoxItem. Pokud ho nezadáte, výchozí výběr bude prázdný (uživatel nic neuvidí). |
| položek | IList<ToastSelectionBoxItem> | false | Položky výběru, ze které si uživatel může vybrat v tomto prvku SelectionBox. Lze přidat pouze 5 položek. |
IToastButton
Značkové rozhraní pro tlačítka oznámení.
| Implementace |
|---|
| ToastButton |
| ToastButtonSnooze |
| ToastButtonDismiss |
ToastButton
Implementuje IToastButton.
Tlačítko, na které může uživatel kliknout.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Content | řetězec | pravda | Povinné. Text, který se má zobrazit na tlačítku. |
| Arguments | řetězec | pravda | Povinné. Řetězec argumentů definovaných aplikací, které aplikace později obdrží, pokud uživatel klikne na toto tlačítko. |
| ActivationType | ToastActivationType | false | Určuje, jaký typ aktivace bude toto tlačítko používat po kliknutí. Výchozí nastavení je popředí. |
| ActivationOptions | ToastActivationOptions | false | Získá nebo nastaví další možnosti týkající se aktivace tlačítka oznámení. |
ToastActivationType
Určuje typ aktivace, který se použije, když uživatel komunikuje s konkrétní akcí.
| Hodnota | Význam |
|---|---|
| Foreground | Výchozí hodnota. Vaše aplikace v popředí byla spuštěna. |
| Pozadí | Spustí se odpovídající úloha na pozadí (za předpokladu, že nastavíte vše) a můžete spustit kód na pozadí (například odeslání zprávy rychlé odpovědi uživatele) bez přerušení uživatele. |
| Protocol | Spusťte jinou aplikaci pomocí aktivace protokolu. |
ToastActivationOptions
Další možnosti týkající se aktivace
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| AfterActivationBehavior | ToastAfterActivationBehavior | false | Získá nebo nastaví chování, které má toast použít, když uživatel tuto akci vyvolá. To funguje jenom na Desktopu, pro ToastButton a ToastContextMenuItem. |
| ProtocolActivationTargetApplicationPfn | řetězec | false | Pokud používáte toastActivationType.Protocol, můžete volitelně zadat cílový PFN, takže bez ohledu na to, jestli je pro zpracování stejného identifikátoru URI protokolu zaregistrovaných více aplikací, bude vaše požadovaná aplikace vždy spuštěna. |
ToastAfterActivationBehavior
Určuje chování, které má oznámení použít, když uživatel provede akci s oznámením.
| Hodnota | Význam |
|---|---|
| Default | Výchozí chování Informační zpráva bude uzavřena, když uživatel provede akci na ni. |
| PendingUpdate | Po kliknutí uživatele na tlačítko vašeho oznámení zůstane oznámení zobrazeno ve stavu „čekající aktualizace“. Měli byste okamžitě aktualizovat svoji notifikaci z úlohy na pozadí, aby uživatel neviděl tento čekající stav aktualizace příliš dlouho. |
ToastButtonSnooze
Implementuje IToastButton.
Tlačítko pro odložení řízené systémem, které automaticky zajišťuje odklad oznámení.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| CustomContent | řetězec | false | Volitelný vlastní text zobrazený na tlačítku, který přepíše výchozí lokalizovaný text "Odložit". |
ToastButtonDismiss
Implementuje IToastButton.
Systémem řízené tlačítko pro zavření, které po kliknutí zavře oznámení.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| CustomContent | řetězec | false | Volitelný vlastní text zobrazený na tlačítku, který přepíše výchozí lokalizovaný text "Zavřít". |
ToastActionsSnoozeAndDismiss
*Implementuje IToastActions
Automaticky vytvoří pole výběru pro odložení intervalů a tlačítka pro odložení/ignorování, všechna automaticky lokalizovaná, a logiku odložení automaticky zpracovává systém.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| ContextMenuItems | IList<ToastContextMenuItem> | false | Vlastní položky místní nabídky, které poskytují další akce, pokud uživatel klikne pravým tlačítkem myši na oznámení. Můžete mít maximálně 5 položek. |
ToastContextMenuItem
Položka místní nabídky.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Content | řetězec | pravda | Povinné. Text k zobrazení |
| Arguments | řetězec | pravda | Povinné. Řetězec argumentů definovaný aplikací, který může aplikace později načíst, jakmile je aktivována poté, co uživatel klikne na položku nabídky. |
| ActivationType | ToastActivationType | false | Určuje, jaký typ aktivace bude tato položka nabídky používat po kliknutí. Výchozí nastavení je popředí. |
| ActivationOptions | ToastActivationOptions | false | Další možnosti týkající se aktivace položky místní nabídky informačních zpráv |
ToastAudio
Zadejte zvuk, který se má přehrát při přijetí oznámení aplikace.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Src | URI | false | Multimediální soubor, který se má přehrát místo výchozího zvuku. Podporují se jenom ms-appx a ms-resource. Všechny ostatní (ms-appdata, http, C:atd.) se nepodporují. |
| Loop | Boolean | false | Nastavte hodnotu true, pokud se má zvuk opakovat, dokud je oznámení zobrazeno; false pro přehrání pouze jednou (výchozí). |
| Silent | Boolean | false | Hodnota "true" pro ztlumení zvuku; "false" umožňuje přehrát zvuk oznámení aplikace (výchozí). |
ToastHeader
Vlastní hlavička, která seskupuje více oznámení v Centru oznámení.
| Vlastnictví | Typ | Povinné | Description |
|---|---|---|---|
| Id | řetězec | pravda | Identifikátor vytvořený vývojářem, který jednoznačně identifikuje tuto hlavičku. Pokud dvě oznámení mají stejné ID záhlaví, zobrazí se pod stejným záhlavím v Centru oznámení. |
| Titul | řetězec | pravda | Název záhlaví. |
| Arguments | řetězec | pravda | Získá nebo nastaví řetězec argumentů definovaný vývojářem, který se vrátí do aplikace, když uživatel klikne na tuto hlavičku. Nesmí být null. |
| ActivationType | ToastActivationType | false | Získá nebo nastaví typ aktivace, který tato hlavička použije při kliknutí. Výchozí nastavení je popředí. Mějte na paměti, že se podporují pouze foreground a Protocol. |
| ActivationOptions | ToastActivationOptions | false | Získá nebo nastaví další možnosti týkající se aktivace hlavičky oznámení. |
Příbuzná témata
- Rychlý start: Odeslání místního oznámení a zpracování aktivace
Windows developer