Udostępnij przez

Schemat zawartości Toast

Poniżej opisano wszystkie właściwości i elementy w zawartości powiadomienia typu toast.

Jeśli wolisz używać nieprzetworzonego kodu XML zamiast biblioteki Powiadomień, zobacz schemat XML.

ToastContent

ToastContent

ToastContent to obiekt najwyższego poziomu, który opisuje zawartość powiadomienia, w tym wizualizacje, akcje i dźwięk.

Property Typ Required Description
Launch ciąg false Ciąg przekazywany do aplikacji, gdy zostanie ona aktywowana przez Toast. Format i zawartość tego ciągu są definiowane przez aplikację do użytku własnego. Gdy użytkownik stuknie lub kliknie powiadomienie typu Toast, aby uruchomić powiązaną aplikację, ciąg uruchamiania udostępnia kontekst aplikacji, który umożliwia wyświetlenie użytkownikowi widoku istotnego dla zawartości powiadomienia Toast, a nie uruchamiania domyślnym sposobem.
Visual ToastVisual true Opisuje wizualną część powiadomienia typu toast.
Actions IToastActions false Opcjonalnie utwórz akcje niestandardowe za pomocą przycisków i danych wejściowych.
Audio ToastAudio false Opisuje część dźwiękową powiadomienia.
ActivationType ToastActivationType false Określa typ aktywacji, który będzie używany, gdy użytkownik kliknie powiadomienie tego komunikatu Toast.
ActivationOptions ToastActivationOptions false Nowość w Aktualizacji dla Twórców: dodatkowe opcje dotyczące aktywacji powiadomień toast.
Scenario ToastScenario false Deklaruje scenariusz używany dla powiadomienia toast, na przykład alarmu lub przypomnienia.
DisplayTimestamp DateTimeOffset? false Nowość w aktualizacji dla twórców: zastąpij domyślny znacznik czasu niestandardowym znacznikiem czasu reprezentującym, kiedy zawartość powiadomienia została rzeczywiście dostarczona, zamiast czasu otrzymania powiadomienia przez platformę systemu Windows.
Header ToastHeader false Nowość w aktualizacji dla twórców: dodaj nagłówek niestandardowy do powiadomienia, aby zgrupować wiele powiadomień w Centrum akcji.

ToastScenario

Określa, jaki scenariusz reprezentuje komunikat typu toast.

Value Meaning
Default Normalne zachowanie powiadomienia.
Przypomnienie Powiadomienie z przypomnieniem. Zostanie on wyświetlony wstępnie rozwinięty i pozostanie na ekranie użytkownika do czasu odrzucenia.
Alarm Powiadomienie o alarmie. Zostanie on wyświetlony wstępnie rozwinięty i pozostanie na ekranie użytkownika do czasu odrzucenia. Dźwięk będzie domyślnie pętlony i będzie wykorzystywać dźwięk alarmowy.
IncomingCall Powiadomienie o połączeniu przychodzącym. Zostanie to wyświetlone wstępnie rozwinięte w specjalnym formacie połączenia i pozostanie na ekranie użytkownika do czasu odrzucenia. Dźwięk będzie odtwarzany w pętli domyślnie i będzie używać formatu dzwonka.

ToastVisual

Wizualna część powiadomień zawiera powiązania, które obejmują tekst, obrazy, zawartość adaptacyjną i inne elementy.

Property Typ Required Description
BindingGeneric ToastBindingGeneric true Uniwersalne powiązanie toastowe, które można renderować na wszystkich urządzeniach. To powiązanie jest wymagane i nie może mieć wartości null.
BaseUri Uri false Domyślny podstawowy adres URL połączony z względnymi adresami URL w atrybutach źródła obrazu.
AddImageQuery bool? false Ustaw „true”, aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu wyskakującym. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Language ciąg false Docelowe ustawienia regionalne treści wizualnej podczas używania zlokalizowanych zasobów, określone jako tagi języka BCP-47, takich jak "en-US" lub "fr-FR". Te ustawienia regionalne są zastępowane przez dowolne ustawienia regionalne określone w powiązaniu lub tekście. Jeśli nie zostanie podana, zostaną użyte ustawienia regionalne systemu.

ToastBindingGeneric

Powiązanie ogólne jest domyślnym powiązaniem dla powiadomień typu "toast", i jest miejscem, gdzie określasz tekst, obrazy, zawartość adaptacyjną i inne elementy.

Property Typ Required Description
Children <IList> false Zawartość treści wyskakującego okienka, która może zawierać tekst, obrazy i grupy (dodane w aktualizacji rocznicowej). Elementy tekstowe muszą znajdować się przed innymi elementami, a obsługiwane są tylko 3 elementy tekstowe. Jeśli element tekstowy zostanie umieszczony po jakimkolwiek innym elemecie, zostanie on ściągnięty na górę lub upuszczony. Na koniec niektóre właściwości tekstu, takie jak HintStyle, nie są obsługiwane w elementach tekstowych podrzędnych głównych elementów i działają tylko wewnątrz AdaptiveSubgroup. Jeśli używasz elementu AdaptiveGroup na urządzeniach bez Aktualizacji Rocznicowej, zawartość grupy zostanie po prostu pominięta.
AppLogoOverride ToastGenericAppLogo false Opcjonalne logo do zastąpienia logo aplikacji.
HeroImage ToastGenericHeroImage false Opcjonalny wyróżniony obraz „hero”, wyświetlany w powiadomieniu i Centrum akcji.
Attribution ToastGenericAttributionText false Opcjonalny tekst przypisania, który będzie wyświetlany w dolnej części wyskakującego powiadomienia.
BaseUri Uri false Domyślny podstawowy adres URL połączony z względnymi adresami URL w atrybutach źródła obrazu.
AddImageQuery bool? false Ustaw „true”, aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu wyskakującym. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Language ciąg false Docelowe ustawienia regionalne treści wizualnej podczas używania zlokalizowanych zasobów, określone jako tagi języka BCP-47, takich jak "en-US" lub "fr-FR". Te ustawienia regionalne są zastępowane przez dowolne ustawienia regionalne określone w powiązaniu lub tekście. Jeśli nie zostanie podana, zostaną użyte ustawienia regionalne systemu.

IToastBindingGenericChild

Interfejs znacznika dla wyskakujących elementów podrzędnych zawierających tekst, obrazy, grupy i inne.

Implementations
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

Element adaptacyjnego tekstu. Jeśli zostanie umieszczona na najwyższym poziomie ToastBindingGeneric.Children, zastosowanie znajdzie jedynie HintMaxLines. Jeśli jednak zostanie to umieszczone jako element podrzędny grupy/podgrupy, obsługiwane jest pełne stylizowanie tekstu.

Property Typ Required Description
Text Ciąg lub BindableString false Tekst do wyświetlenia. Obsługa powiązania danych dodana w aktualizacji dla twórców, ale działa tylko w przypadku elementów tekstowych najwyższego poziomu.
HintStyle AdaptiveTextStyle false Styl określa rozmiar czcionki, wagę i nieprzezroczystość tekstu. Działa tylko dla elementów tekstowych wewnątrz grupy/podgrupy.
HintWrap bool? false Ustaw wartość true, aby włączyć zawijanie tekstu. Elementy tekstowe najwyższego poziomu ignorują tę właściwość i zawsze zawijają (można użyć funkcji HintMaxLines = 1, aby wyłączyć zawijanie elementów tekstowych najwyższego poziomu). Elementy tekstowe wewnątrz grup/podgrup domyślnie mają wartość false w przypadku zawijania.
HintMaxLines int? false Maksymalna liczba wierszy, które element tekstowy może wyświetlić.
HintMinLines int? false Minimalna liczba wierszy, które musi wyświetlać element tekstowy. Działa tylko dla elementów tekstowych wewnątrz grupy/podgrupy.
HintAlign AdaptiveTextAlign false Wyrównanie tekstu w poziomie. Działa tylko dla elementów tekstowych wewnątrz grupy/podgrupy.
Language ciąg false Docelowa lokalizacja zawartości XML określona jako tagi języka BCP-47, takie jak "en-US" lub "fr-FR". Ustawienia regionalne określone tutaj zastępują każde inne określone ustawienia regionalne, takie jak w bindowaniu lub wizualizacji. Jeśli ta wartość jest dosłownym ciągiem znaków, ten atrybut domyślnie przyjmuje język interfejsu użytkownika. Jeśli ta wartość jest odwołaniem do ciągu, ten atrybut domyślnie przyjmuje ustawienia regionalne wybrane przez środowisko uruchomieniowe systemu Windows przy rozwiązywaniu ciągu.

BindableString

Wartość powiązania dla ciągów.

Property Typ Required Description
BindingName ciąg true Pobiera lub ustawia nazwę, która odpowiada wartości powiązania danych.

AdaptiveTextStyle

Styl tekstu określa rozmiar czcionki, wagę i nieprzezroczystość. Subtelna nieprzezroczystość wynosi 60%, a kod kolorystyczny to%.

Value Meaning
Default Wartość domyślna. Styl jest określany przez moduł renderowania.
Caption Mniejszy od rozmiaru czcionki w akapicie.
CaptionSubtle Tak samo jak nagłówek, ale z subtelną przezroczystością.
Body Rozmiar czcionki akapitu.
BodySubtle Tak samo jak Ciało, ale z subtelną nieprzezroczystością.
Base Rozmiar czcionki akapitu, pogrubiona waga. Zasadniczo pogrubiona wersja Body.
BaseSubtle Tak samo jak baza, ale z subtelną nieprzezroczystością.
Subtitle Rozmiar czcionki H4.
SubtitleSubtle Tak samo jak podtytuł, ale z subtelną nieprzezroczystością.
Title Rozmiar czcionki H3.
TitleSubtle Tak samo jak Tytuł, ale z subtelną nieprzezroczystością.
TitleNumeral Tak samo jak Tytuł, ale z usuniętymi marginesami u góry i u dołu.
Subheader Rozmiar czcionki H2.
SubheaderSubtle Taki sam jak Subheader, ale z subtelną nieprzezroczystością.
SubheaderNumeral Tak samo jak podtytuł, ale z usuniętym górnym i dolnym marginesem.
Header Rozmiar czcionki H1.
HeaderSubtle Tak samo jak nagłówek, ale z subtelną nieprzezroczystością.
HeaderNumeral Tak samo jak nagłówek, ale z górnym i dolnym marginesem usuniętym.

AdaptiveTextAlign

Określa wyrównanie tekstu w poziomie.

Value Meaning
Default Wartość domyślna. Wyrównanie jest automatycznie określane przez moduł renderowania.
Auto Wyrównanie określone przez bieżący język i kulturę.
Left Wyrównaj tekst do lewej strony.
Center Wyrównaj tekst poziomo do środka.
Right Wyrównaj tekst w poziomie do prawej strony.

AdaptiveImage

Obraz w linii.

Property Typ Required Description
Source ciąg true Adres URL obrazu. Obsługiwane są pliki ms-appx, ms-appdata i http. W ramach aktualizacji Fall Creators Update obrazy internetowe mogą mieć do 3 MB na zwykłych połączeniach i 1 MB w przypadku połączeń taryfowych. Na urządzeniach, na których nie uruchomiono jeszcze aktualizacji Fall Creators Update, obrazy internetowe nie mogą być większe niż 200 KB.
HintCrop AdaptiveImageCrop false Nowość w aktualizacji rocznicowej: kontroluj żądane przycinanie obrazu.
HintRemoveMargin bool? false Domyślnie obrazy wewnątrz grup/podgrup mają margines 8 pikseli wokół nich. Ten margines można usunąć, ustawiając tę właściwość na true.
HintAlign AdaptiveImageAlign false Wyrównanie w poziomie obrazu. Działa tylko dla obrazów wewnątrz grupy/podgrupy.
Tekst alternatywny ciąg false Alternatywny tekst opisujący obraz używany do celów ułatwień dostępu.
AddImageQuery bool? false Ustaw „true”, aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu wyskakującym. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

AdaptiveImageCrop

Określa żądane przycinanie obrazu.

Value Meaning
Default Wartość domyślna. Zachowanie przycinania określone przez moduł renderowania.
None Obraz nie jest przycięty.
Circle Obraz jest przycinany do kształtu okręgu.

AdaptiveImageAlign

Określa wyrównanie w poziomie dla obrazu.

Value Meaning
Default Wartość domyślna. Zachowanie wyrównania określone przez moduł renderowania.
Stretch Obraz rozciąga się w celu wypełnienia dostępnej szerokości (i potencjalnie dostępnej wysokości również w zależności od miejsca umieszczenia obrazu).
Left Wyrównaj obraz do lewej strony, wyświetlając obraz w natywnej rozdzielczości.
Center Wyrównaj obraz poziomo na środku, wyświetlając obraz w jego natywnej rozdzielczości.
Right Wyrównaj obraz do prawej strony, wyświetlając obraz w natywnej rozdzielczości.

AdaptiveGroup

Nowość w aktualizacji rocznicowej: grupy semantycznie identyfikują, że zawartość w grupie musi być wyświetlana jako całość lub nie jest wyświetlana, jeśli nie może pasować. Grupy umożliwiają również tworzenie wielu kolumn.

Property Typ Required Description
Children IList<AdaptiveSubgroup> false Podgrupy są wyświetlane jako kolumny pionowe. Należy użyć podgrup, aby udostępnić dowolną zawartość wewnątrz grupy adaptacyjnej.

AdaptiveSubgroup

Nowość w aktualizacji rocznicowej: podgrupy to kolumny pionowe, które mogą zawierać tekst i obrazy.

Property Typ Required Description
Children <IListIAdaptiveSubgroupChild> false AdaptiveText i AdaptiveImage są prawidłowymi elementami podgrup.
HintWeight int? false Zarządzaj szerokością tej kolumny podgrupy, ustalając wagę względem innych podgrup.
HintTextStacking AdaptiveSubgroupTextStacking false Kontroluj pionowe wyrównanie zawartości tej podgrupy.

IAdaptiveSubgroupChild

Interfejs znacznikowy dla dzieci podgrupy.

Implementations
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking określa wyrównanie pionowe zawartości.

Value Meaning
Default Wartość domyślna. Program renderowany automatycznie wybiera domyślne wyrównanie w pionie.
Top Wyrównaj pionowo do góry.
Center Wyrównaj w pionie do środka.
Bottom Wyrównaj pionowo do dołu.

AdaptiveProgressBar

Nowość w aktualizacji dla twórców: pasek postępu. Obsługiwane tylko na wyskakujące powiadomienia w programie Desktop, kompilacji 15063 lub nowszej.

Property Typ Required Description
Title Ciąg lub BindableString false Pobiera lub ustawia opcjonalny ciąg tytułu. Obsługuje powiązanie danych.
Value double lub AdaptiveProgressBarValue lub BindableProgressBarValue false Pobiera lub ustawia wartość paska postępu. Obsługuje powiązanie danych. Wartość domyślna to 0.
ValueStringOverride Ciąg lub BindableString false Pobiera lub ustawia opcjonalny ciąg, który ma być wyświetlany zamiast domyślnego ciągu procentowego. Jeśli to nie zostanie podane, zostanie wyświetlony komunikat podobny do "70%".
Status Ciąg lub BindableString true Pobiera lub ustawia ciąg stanu (wymagany), który jest wyświetlany pod paskiem postępu po lewej stronie. Ten ciąg powinien odzwierciedlać stan operacji, na przykład "Pobieranie..." lub "Instalowanie..."

AdaptiveProgressBarValue

Klasa reprezentująca wartość paska postępu.

Property Typ Required Description
Value double false Pobiera lub ustawia wartość (0,0 – 1,0) reprezentującą procent wykonania.
IsIndeterminate bool false Pobiera lub ustawia wartość wskazującą, czy pasek postępu jest nieokreślony. Jeśli to prawda, wartość zostanie zignorowana.

BindableProgressBarValue

Wartość paska postępu z możliwością wiązania.

Property Typ Required Description
BindingName ciąg true Pobiera lub ustawia nazwę, która odpowiada wartości powiązania danych.

Logo do wyświetlenia zamiast logo aplikacji.

Property Typ Required Description
Source ciąg true Adres URL obrazu. Obsługiwane są pliki ms-appx, ms-appdata i http. Obrazy HTTP muszą mieć rozmiar 200 KB lub mniejszy.
HintCrop ToastGenericAppLogoCrop false Określ, w jaki sposób chcesz przyciąć obraz.
Tekst alternatywny ciąg false Alternatywny tekst opisujący obraz używany do celów ułatwień dostępu.
AddImageQuery bool? false Ustaw „true”, aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu wyskakującym. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

ToastGenericAppLogoCrop

Steruje przycinaniem obrazu logo aplikacji.

Value Meaning
Default Przycinanie używa domyślnego zachowania modułu renderowania.
None Obraz nie jest przycięty, wyświetlany jest w formacie kwadratu.
Circle Obraz jest przycięty do okręgu.

ToastGenericHeroImage

Polecany obraz „hero”, który jest wyświetlany na powiadomieniach i w centrum akcji.

Property Typ Required Description
Source ciąg true Adres URL obrazu. Obsługiwane są pliki ms-appx, ms-appdata i http. Obrazy HTTP muszą mieć rozmiar 200 KB lub mniejszy.
Tekst alternatywny ciąg false Alternatywny tekst opisujący obraz używany do celów ułatwień dostępu.
AddImageQuery bool? false Ustaw „true”, aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu wyskakującym. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

ToastGenericAttributionText

Tekst przypisania wyświetlany w dolnej części powiadomienia wyskakującego.

Property Typ Required Description
Text ciąg true Tekst do wyświetlenia.
Language ciąg false Docelowe ustawienia regionalne treści wizualnej podczas używania zlokalizowanych zasobów, określone jako tagi języka BCP-47, takich jak "en-US" lub "fr-FR". Jeśli nie zostanie podana, zostaną użyte ustawienia regionalne systemu.

IToastActions

Interfejs znacznika dla wyskakujące akcje/dane wejściowe.

Implementations
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

Implementuje interfejs IToastActions

Utwórz własne akcje niestandardowe i wejścia, używając takich kontrolek jak przyciski, pola tekstowe i opcje wyboru.

Property Typ Required Description
Inputs < IToastInput> false Dane wejściowe, takie jak pola tekstowe i pola wyboru. Dozwolone są tylko 5 danych wejściowych.
Buttons IList<IToastButton> false Przyciski są wyświetlane po wszystkich danych wejściowych (lub obok danych wejściowych, jeśli przycisk jest używany jako przycisk szybkiej odpowiedzi). Dozwolone są maksymalnie 5 przycisków (lub mniej, jeśli masz również elementy menu kontekstowego).
ContextMenuItems IList<ToastContextMenuItem> false Nowość w aktualizacji rocznicowej: niestandardowe elementy menu kontekstowego, udostępniając dodatkowe akcje, jeśli użytkownik kliknie powiadomienie prawym przyciskiem myszy. Możesz mieć maksymalnie 5 przycisków i połączonych elementów menu kontekstowego.

IToastInput

Interfejs znaczników dla powiadomień typu toast.

Implementations
ToastTextBox
ToastSelectionBox

ToastTextBox

Implementuje interfejs IToastInput

Kontrolka pola tekstowego, do którego użytkownik może wpisać tekst.

Property Typ Required Description
Id ciąg true Identyfikator jest wymagany i służy do mapowania tekstu wprowadzonego przez użytkownika na parę klucz-wartość identyfikator/wartość, z której aplikacja korzysta później.
Title ciąg false Tekst tytułu wyświetlany nad polem tekstowym.
PlaceholderContent ciąg false Tekst zastępczy, który ma być wyświetlany w polu tekstowym, gdy użytkownik nie wpisał jeszcze żadnego tekstu.
DefaultInput ciąg false Początkowy tekst do umieszczenia w polu tekstowym. Pozostaw tę wartość null dla pustego pola tekstowego.

ToastSelectionBox

Implementuje IToastInput

Kontrolka pola wyboru, która umożliwia użytkownikom wybranie z listy rozwijanej opcji.

Property Typ Required Description
Id ciąg true Identyfikator jest wymagany. Jeśli użytkownik wybrał ten element, ten identyfikator zostanie przekazany z powrotem do kodu aplikacji, reprezentując wybrany przez nich wybór.
Content ciąg true Zawartość jest wymagana i jest ciągiem wyświetlanym w elemencie wyboru.

ToastSelectionBoxItem

Element pola wyboru (element, który użytkownik może wybrać z listy rozwijanej).

Property Typ Required Description
Id ciąg true Identyfikator jest wymagany i służy do mapowania tekstu wprowadzonego przez użytkownika na parę klucz-wartość identyfikator/wartość, z której aplikacja korzysta później.
Title ciąg false Tekst tytułu wyświetlany nad polem zaznaczenia.
DefaultSelectionBoxItemId ciąg false Ten element kontroluje, który element jest domyślnie wybierany, i odnosi się do właściwości Id ToastSelectionBoxItem. Jeśli tego nie podasz, domyślny wybór będzie pusty (użytkownik nie widzi nic).
Items IList<ToastSelectionBoxItem> false Elementy wyboru, które użytkownik może wybrać z tej listy wyboru. Można dodać tylko 5 elementów.

IToastButton

Interfejs znacznika dla przycisków toast.

Implementations
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implementuje funkcję IToastButton

Przycisk, który użytkownik może kliknąć.

Property Typ Required Description
Content ciąg true Required. Tekst do wyświetlenia na przycisku.
Arguments ciąg true Required. Zdefiniowany przez aplikację ciąg argumentów, które aplikacja otrzyma później, jeśli użytkownik kliknie ten przycisk.
ActivationType ToastActivationType false Określa typ aktywacji tego przycisku, który będzie używany po kliknięciu. Wartość domyślna to Przód.
ActivationOptions ToastActivationOptions false Nowość w Aktualizacji Twórców: pobieranie lub ustawianie dodatkowych opcji związanych z aktywacją przycisku wyskakującego.

ToastActivationType

Decyduje o typie aktywacji, który będzie używany podczas interakcji użytkownika z określoną akcją.

Value Meaning
Foreground Wartość domyślna. Aplikacja pierwszego planu została uruchomiona.
Background Odpowiednie zadanie w tle (przy założeniu, że wszystko zostało skonfigurowane) jest wyzwalane i można wykonać kod w tle (na przykład wysyłanie szybkiej odpowiedzi użytkownika) bez przerywania działania użytkownika.
Protocol Uruchom inną aplikację przy użyciu aktywacji protokołu.

ToastActivationOptions

Nowość w aktualizacji dla twórców: dodatkowe opcje związane z aktywacją.

Property Typ Required Description
AfterActivationBehavior ToastAfterActivationBehavior false Nowość w aktualizacji Fall Creators: Pobiera lub ustawia zachowanie, którego toast powinien używać, gdy użytkownik wykonuje tę akcję. Działa to tylko na komputerze stacjonarnym w przypadku ToastButton i ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn ciąg false Jeśli używasz ToastActivationType.Protocol, możesz opcjonalnie określić docelowy PFN, aby niezależnie od tego, czy wiele aplikacji jest zarejestrowanych do obsługi tego samego protokołu URI, żądana aplikacja zostanie zawsze uruchomiona.

ToastAfterActivationBehavior

Określa zachowanie, którego ma używać powiadomienie, gdy użytkownik podejmuje akcję na wyskakujących elementach.

Value Meaning
Default Domyślne zachowanie. Komunikat zostanie zamknięty, gdy użytkownik podejmie akcję na komunikacie.
PendingUpdate Gdy użytkownik kliknie przycisk na Twoim powiadomieniu typu toast, powiadomienie pozostanie widoczne w stanie "oczekiwanie na aktualizację". Należy natychmiast zaktualizować powiadomienie z zadania w tle, żeby użytkownik nie widział tego stanu wizualnego „oczekującej aktualizacji” zbyt długo.

ToastButtonSnooze

Implementuje funkcję IToastButton

Przycisk snooze obsługiwany przez system, który automatycznie obsługuje odłożenie powiadomienia.

Property Typ Required Description
CustomContent ciąg false Opcjonalny tekst niestandardowy wyświetlany na przycisku, który zastępuje domyślny zlokalizowany tekst "Snooze".

ToastButtonDismiss

Implementuje funkcję IToastButton

Przycisk odrzucania obsługiwanego przez system, który odrzuca powiadomienie po kliknięciu.

Property Typ Required Description
CustomContent ciąg false Opcjonalny tekst niestandardowy wyświetlany na przycisku, który zastępuje domyślny zlokalizowany tekst "Odrzuć".

ToastActionsSnoozeAndDismiss

*Implementuje iToastActions

Automatycznie konstruuje listę rozwijaną dla interwałów odraczania oraz przyciski odraczania/odrzucania; wszystkie te elementy są automatycznie zlokalizowane, a logika odraczania jest automatycznie obsługiwana przez system.

Property Typ Required Description
ContextMenuItems IList<ToastContextMenuItem> false Nowość w aktualizacji rocznicowej: niestandardowe elementy menu kontekstowego, udostępniając dodatkowe akcje, jeśli użytkownik kliknie powiadomienie prawym przyciskiem myszy. Można mieć maksymalnie 5 elementów.

ToastContextMenuItem

Wpis elementu menu kontekstowego.

Property Typ Required Description
Content ciąg true Required. Tekst do wyświetlenia.
Arguments ciąg true Required. Zdefiniowany przez aplikację ciąg argumentów, które aplikacja może później pobrać po aktywowaniu, gdy użytkownik kliknie element menu.
ActivationType ToastActivationType false Określa typ aktywacji, który będzie używany przez ten element menu po kliknięciu. Wartość domyślna to Przód.
ActivationOptions ToastActivationOptions false Nowość w aktualizacji dla twórców: dodatkowe opcje dotyczące aktywacji wyskakujących elementów menu kontekstowego.

ToastAudio

Określ dźwięk, który ma być odtwarzany po odebraniu powiadomienia typu Toast.

Property Typ Required Description
Src uri false Plik multimedialny do odtwarzania zamiast domyślnego dźwięku. Obsługiwane są tylko ms-appx i ms-resource. Wszystkie inne (ms-appdata, http, C:itp.) nie są obsługiwane.
Loop boolean false Ustaw wartość true, jeśli dźwięk powinien być powtarzany tak długo, jak długo pokazany jest Toast; wartość false, aby odtworzyć go tylko raz (domyślnie).
Silent boolean false Prawda, żeby wyciszyć dźwięk; fałsz, żeby pozwolić na odtwarzanie dźwięku powiadomienia typu toast (ustawienie domyślne).

ToastHeader

Nowość w aktualizacji dla twórców: niestandardowy nagłówek, który grupuje wiele powiadomień razem w Centrum akcji.

Property Typ Required Description
Id ciąg true Identyfikator utworzony przez dewelopera, który jednoznacznie identyfikuje ten nagłówek. Jeśli dwa powiadomienia mają ten sam identyfikator nagłówka, zostaną wyświetlone poniżej tego samego nagłówka w Centrum akcji.
Title ciąg true Tytuł nagłówka.
Arguments ciąg true Pobiera lub ustawia zdefiniowany przez dewelopera ciąg argumentów zwracanych do aplikacji po kliknięciu tego nagłówka przez użytkownika. Nie można mieć wartości null.
ActivationType ToastActivationType false Pobiera lub ustawia typ aktywacji, który będzie używany po kliknięciu tego nagłówka. Wartość domyślna to Przód. Należy pamiętać, że obsługiwane są tylko Foreground i Protocol.
ActivationOptions ToastActivationOptions false Pobiera lub ustawia dodatkowe opcje związane z aktywacją nagłówka powiadomienia.
  • Last updated on