Inhoudsschema voor app-meldingen

Hieronder worden alle eigenschappen en elementen binnen de toastberichtinhoud beschreven.

Als u liever onbewerkte XML gebruikt in plaats van de Windows App SDK builder-API's, raadpleegt u de XML-schema.

ToastContent

ToastContent

ToastContent is het object op het hoogste niveau dat de inhoud van een melding beschrijft, waaronder visuals, acties en audio.

Vastgoed Typ Verplicht Beschrijving
Launch touw onwaar Een tekenreeks die wordt doorgegeven aan de toepassing wanneer deze wordt geactiveerd door de toastmelding. De indeling en inhoud van deze tekenreeks worden gedefinieerd door de app voor eigen gebruik. Wanneer de gebruiker op de Toast klikt of tikt om de bijbehorende app te starten, biedt de startparameter de app de context waarmee een weergave kan worden getoond die relevant is voor de inhoud van de Toast, in plaats van de app op de standaardmanier te starten.
Visueel ToastVisual true Beschrijft het visuele gedeelte van de app-melding.
acties IToastActions onwaar Maak desgewenst aangepaste acties met knoppen en invoer.
Audio ToastAudio onwaar Beschrijft het audiogedeelte van de app-melding.
ActivationType ToastActivationType onwaar Hiermee geeft u op welk activeringstype wordt gebruikt wanneer de gebruiker op de hoofdtekst van deze pop-up klikt.
ActivationOptions ToastActivationOptions onwaar Aanvullende opties met betrekking tot de activering van de app-melding.
Scenario ToastScenario onwaar Declareert het scenario waarvoor uw pop-up wordt gebruikt, zoals een alarm of herinnering.
DisplayTimestamp DateTimeOffset? onwaar Overschrijf de standaardtijdstempel met een aangepaste tijdstempel die aangeeft wanneer de inhoud van uw melding daadwerkelijk is bezorgd, in plaats van de tijd dat de melding is ontvangen door het Windows-platform.
Koptekst ToastHeader onwaar Voeg een aangepaste koptekst toe aan uw melding om meerdere meldingen samen te groeperen in het Meldingencentrum.

ToastScenario

Hiermee specificeert u welk scenario de pop-up vertegenwoordigt.

Waarde Meaning
standaard Het normale toastgedrag.
Reminder Een herinneringsmelding. Dit wordt vooraf uitgevouwen weergegeven en blijft op het scherm van de gebruiker totdat deze wordt gesloten.
Alarm Een alarmmelding. Dit wordt vooraf uitgevouwen weergegeven en blijft op het scherm van de gebruiker totdat deze wordt gesloten. Audio wordt standaard herhaald en zal alarmgeluid gebruiken.
IncomingCall Een melding voor binnenkomende oproepen. Dit wordt vooraf uitgevouwen in een speciaal oproepformaat en blijft op het scherm van de gebruiker staan totdat de gebruiker het sluit. Audio wordt standaard in een lus afgespeeld en zal de ringtone gebruiken.

ToastVisual

Het visuele gedeelte van meldingen bevat de bindingen, die tekst, afbeeldingen, adaptieve inhoud en meer omvatten.

Vastgoed Typ Verplicht Beschrijving
BindingGeneric ToastBindingGeneric true De universele toastbinding, die op alle apparaten kan worden weergegeven. Deze binding is vereist en kan niet null zijn.
BaseUri Uri onwaar Een standaardbasis-URL die wordt gecombineerd met relatieve URL's in afbeeldingsbronkenmerken.
AddImageQuery bool? onwaar Stel in op 'true' om Windows toe te staan een querystring toe te voegen aan de afbeeldings-URL die in de app-melding is opgegeven. Gebruik dit kenmerk als uw server als host fungeert voor afbeeldingen en queryreeksen kan verwerken, hetzij door een afbeeldingsvariabele op te halen op basis van de queryreeksen of door de queryreeks te negeren en de afbeelding te retourneren zoals opgegeven zonder de querytekenreeks. Deze querytekenreeks specificeert schaal, contrastinstelling en taal; De waarde 'www.website.com/images/hello.png' die in de melding wordt gegeven, wordt bijvoorbeeld 'www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us'
Taal touw onwaar De doellocatie van de visuele payload wanneer u gebruik maakt van gelokaliseerde resources, opgegeven als BCP-47-taaltags, zoals 'en-US' of 'fr-FR'. Deze taalinstelling wordt overschreven door elke taalinstelling die is opgegeven in een binding of tekst. Indien niet opgegeven, wordt de landinstelling van het systeem gebruikt.

ToastBindingGeneric

De algemene binding is de standaardbinding voor meldingen en is waar u de tekst, afbeeldingen, adaptieve inhoud en meer opgeeft.

Vastgoed Typ Verplicht Beschrijving
Kinderen IList<IToastBindingGenericChild> onwaar De inhoud van de hoofdtekst van de pop-up, die tekst, afbeeldingen en groepen kan bevatten. Tekstelementen moeten vóór alle andere elementen komen en er worden slechts drie tekstelementen ondersteund. Als een tekstelement na een ander element wordt geplaatst, wordt het omhoog geplaatst of omlaag verplaatst. En tot slot worden bepaalde teksteigenschappen zoals HintStyle niet ondersteund op de hoofd-kindtekstelementen en werken alleen binnen een AdaptiveSubgroup.
AppLogoOverride ToastGenericAppLogo onwaar Een optioneel logo om het app-logo te overschrijven.
HeroImage ToastGenericHeroImage onwaar Een optionele aanbevolen 'hero'-afbeelding die wordt weergegeven op de toastmelding en in het meldingscentrum.
Attribution ToastGenericAttributionText onwaar Optionele toeschrijvingstekst die onder aan de app-melding wordt weergegeven.
BaseUri Uri onwaar Een standaardbasis-URL die wordt gecombineerd met relatieve URL's in afbeeldingsbronkenmerken.
AddImageQuery bool? onwaar Ingesteld op "true" zodat Windows een querystring kan toevoegen aan de URL van de afbeelding die is opgegeven in de app-melding. Gebruik dit kenmerk als uw server als host fungeert voor afbeeldingen en queryreeksen kan verwerken, hetzij door een afbeeldingsvariabele op te halen op basis van de queryreeksen of door de queryreeks te negeren en de afbeelding te retourneren zoals opgegeven zonder de querytekenreeks. Deze querytekenreeks specificeert schaal, contrastinstelling en taal; De waarde 'www.website.com/images/hello.png' die in de melding wordt gegeven, wordt bijvoorbeeld 'www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us'
Taal touw onwaar De doellocatie van de visuele payload wanneer u gebruik maakt van gelokaliseerde resources, opgegeven als BCP-47-taaltags, zoals 'en-US' of 'fr-FR'. Deze taalinstelling wordt overschreven door elke taalinstelling die is opgegeven in een binding of tekst. Indien niet opgegeven, wordt de landinstelling van het systeem gebruikt.

IToastBindingGenericChild

Markeringsinterface voor toast-onderdelen die tekst, afbeeldingen, groepen en meer bevatten.

Implementaties
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

Een adaptief tekstelement. Als u op het hoogste niveau ToastBindingGeneric.Children wordt geplaatst, worden alleen HintMaxLines toegepast. Maar als dit wordt geplaatst als onderliggend element van een groep/subgroep, wordt volledige tekstopmaak ondersteund.

Vastgoed Typ Verplicht Beschrijving
Text tekenreeks of BindableString- onwaar De weer te geven tekst. Gegevensbinding werkt alleen voor tekstelementen op het hoogste niveau.
HintStyle AdaptiveTextStyle onwaar De stijl bepaalt de lettergrootte, dikte en doorzichtigheid van de tekst. Werkt alleen voor tekstelementen in een groep/subgroep.
HintWrap bool? onwaar Stel dit in op true om tekstomloop in te schakelen. Tekstelementen op het hoogste niveau negeren deze eigenschap en laten altijd teruglopen (u kunt HintMaxLines = 1 gebruiken om terugloop uit te schakelen voor tekstelementen op het hoogste niveau). Tekstelementen in groepen/subgroepen hebben standaard geen regelafbreking.
HintMaxLines int? onwaar Het maximum aantal regels dat het tekstelement mag weergeven.
HintMinLines int? onwaar Het minimale aantal regels dat het tekstelement moet weergeven. Werkt alleen voor tekstelementen in een groep/subgroep.
HintAlign AdaptiveTextAlign onwaar De horizontale uitlijning van de tekst. Werkt alleen voor tekstelementen in een groep/subgroep.
Taal touw onwaar De doellocale van de XML-payload, die is opgegeven als een BCP-47-taaltag, zoals 'en-US' of 'fr-FR'. De hier opgegeven landinstelling overschrijft alle andere opgegeven landinstellingen, zoals die in binding of visual. Als deze waarde een letterlijke tekenreeks is, wordt dit kenmerk standaard ingesteld op de gebruikersinterfacetaal van de gebruiker. Als deze waarde een tekenreeksverwijzing is, wordt dit kenmerk standaard ingesteld op de landinstelling die is gekozen door Windows Runtime bij het omzetten van de tekenreeks.

BindableString

Een bindingswaarde voor tekenreeksen.

Vastgoed Typ Verplicht Beschrijving
BindingName touw true Hiermee kunt u de naam ophalen of instellen die overeenkomt met uw bindingswaarde.

AdaptiveTextStyle

Tekststijl bepaalt de tekengrootte, dikte en doorzichtigheid. "Een subtiele dekking betekent 60% in opaciteit."

Waarde Meaning
standaard Standaardwaarde. De stijl wordt bepaald door de renderer.
Bijschrift Kleiner dan alineatekengrootte.
CaptionSubtle Hetzelfde als bijschrift, maar met subtiele opaciteit.
Body Lettergrootte van alinea.
BodySubtle Hetzelfde als Lichaam, maar met subtiele transparantie.
Base Lettertypegrootte van alinea, vetgedrukt. Eigenlijk de vetgedrukte versie van Body.
BaseSubtle Hetzelfde als Base, maar met subtiele transparantie.
Subtitle H4-tekengrootte.
SubtitleSubtle Hetzelfde als ondertitel maar met subtiele opaciteit.
Titel H3-tekengrootte.
TitleSubtle Hetzelfde als titel, maar met subtiele opaciteit.
TitleNumeral Hetzelfde als Titel, maar met verwijderde boven- en ondermarges.
Subheader H2-tekengrootte.
SubheaderSubtle Hetzelfde als Subheader, maar met subtiele ondoorzichtigheid.
SubheaderNumeral Hetzelfde als subkoptekst, maar de opvulling, zowel boven als onder, is verwijderd.
Koptekst H1-tekengrootte.
HeaderSubtle Hetzelfde als de header, maar met subtiele opaciteit.
HeaderNumeral Hetzelfde als de koptekst, maar zonder boven- en onderopvulling.

AdaptiveTextAlign

Hiermee bepaalt u de horizontale uitlijning van tekst.

Waarde Meaning
standaard Standaardwaarde. Uitlijning wordt automatisch bepaald door de renderer.
Auto Uitlijning bepaald door de huidige taal en cultuur.
Left Lijn de tekst horizontaal uit aan de linkerkant.
Center Lijn de tekst in het midden horizontaal uit.
Rechts Lijn de tekst horizontaal uit naar rechts.

AdaptiveImage

Een inline-afbeelding.

Vastgoed Typ Verplicht Beschrijving
bron touw true De URL naar de afbeelding. ms-appx, ms-appdata en http worden ondersteund. Webafbeeldingen kunnen maximaal 3 MB zijn op normale verbindingen en 1 MB op verbindingen met datalimiet.
HintCrop AdaptiveImageCrop onwaar Controleer de gewenste bijsnijding van de afbeelding.
HintRemoveMargin bool? onwaar Afbeeldingen in groepen/subgroepen hebben standaard een marge van 8 pixels. U kunt deze marge verwijderen door deze eigenschap op True in te stellen.
HintAlign AdaptiveImageAlign onwaar De horizontale uitlijning van de afbeelding. Werkt alleen voor afbeeldingen in een groep/subgroep.
AlternateText touw onwaar Alternatieve tekst die de afbeelding beschrijft, die wordt gebruikt voor toegankelijkheidsdoeleinden.
AddImageQuery bool? onwaar Ingesteld op 'true' om Windows toe te staan een queryreeks aan de afbeeldings-URL toe te voegen die is opgegeven in de app-melding. Gebruik dit kenmerk als uw server als host fungeert voor afbeeldingen en queryreeksen kan verwerken, hetzij door een afbeeldingsvariabele op te halen op basis van de queryreeksen of door de queryreeks te negeren en de afbeelding te retourneren zoals opgegeven zonder de querytekenreeks. Deze querytekenreeks specificeert schaal, contrastinstelling en taal; De waarde 'www.website.com/images/hello.png' die in de melding wordt gegeven, wordt bijvoorbeeld 'www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us'

AdaptiveImageCrop

Geeft de gewenste bijsnijding van de afbeelding aan.

Waarde Meaning
standaard Standaardwaarde. Het bijsnijdgedrag wordt bepaald door het weergaveprogramma.
Geen Afbeelding is niet bijgesneden.
Circle Afbeelding wordt bijgesneden tot een cirkelvorm.

AdaptiveImageAlign

Hiermee geeft u de horizontale uitlijning voor een afbeelding.

Waarde Meaning
standaard Standaardwaarde. Uitlijningsgedrag bepaald door renderer.
Stretch Afbeelding wordt uitgerekt om de beschikbare breedte op te vullen (en mogelijk ook beschikbare hoogte, afhankelijk van waar de afbeelding wordt geplaatst).
Left Lijn de afbeelding links uit en geef de afbeelding weer op de systeemeigen resolutie.
Center Lijn de afbeelding horizontaal uit in het midden en geef de afbeelding weer met de systeemeigen resolutie.
Rechts Lijn de afbeelding rechts uit en geef de afbeelding weer met de systeemeigen resolutie.

AdaptiveGroup

Groepen identificeren semantisch dat de inhoud in de groep moet worden weergegeven als geheel of niet als deze niet past. Met groepen kunt u ook meerdere kolommen maken.

Vastgoed Typ Verplicht Beschrijving
Kinderen IList<AdaptiveSubgroup> onwaar Subgroepen worden weergegeven als verticale kolommen. U moet subgroepen gebruiken om inhoud in een AdaptiveGroup op te geven.

AdaptiveSubgroup

Subgroepen zijn verticale kolommen die tekst en afbeeldingen kunnen bevatten.

Vastgoed Typ Verplicht Beschrijving
Kinderen IList<IAdaptiveSubgroupChild> onwaar AdaptiveText en AdaptiveImage zijn geldige onderliggende elementen van subgroepen.
HintWeight int? onwaar Bepaal de breedte van deze subgroepkolom door het gewicht op te geven ten opzichte van de andere subgroepen.
HintTextStacking AdaptiveSubgroupTextStacking onwaar De verticale uitlijning van de inhoud van deze subgroep bepalen.

IAdaptiveSubgroupChild

Markerinterface voor kinderen van subgroepen.

Implementaties
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking geeft de verticale uitlijning van inhoud aan.

Waarde Meaning
standaard Standaardwaarde. In de renderer wordt automatisch de standaard verticale uitlijning geselecteerd.
Top Verticaal uitlijnen naar boven.
Center Verticaal uitlijnen op het midden.
Bottom Verticaal uitlijnen naar de onderkant.

AdaptiveProgressBar

Een voortgangsbalk. Alleen ondersteund op Desktop.

Vastgoed Typ Verplicht Beschrijving
Titel tekenreeks of BindableString- onwaar Hiermee haalt u een optionele titeltekenreeks op of stelt u deze in. Ondersteunt gegevensbinding.
Waarde double of AdaptiveProgressBarValue of BindableProgressBarValue onwaar Hiermee haalt u de waarde van de voortgangsbalk op of stelt u deze in. Ondersteunt gegevensbinding. De standaardwaarde is 0.
ValueStringOverride tekenreeks of BindableString- onwaar Met deze optie kan een optionele tekst worden opgehaald of ingesteld die in plaats van de standaardpercentagetekst moet worden weergegeven. Als dit niet is opgegeven, wordt er iets als '70%' weergegeven.
Status tekenreeks of BindableString- true Hiermee wordt een statustekenreeks (vereist) opgehaald of ingesteld, die wordt weergegeven onder de voortgangsbalk aan de linkerkant. Deze tekenreeks moet de status van de bewerking weerspiegelen, zoals 'Downloaden...' of 'Installeren...'

AdaptiveProgressBarValue

Een klasse die de waarde van de voortgangsbalk vertegenwoordigt.

Vastgoed Typ Verplicht Beschrijving
Waarde dubbel onwaar Verkrijgt of stelt de waarde (0,0 - 1,0) in die het voltooiingspercentage vertegenwoordigt.
IsIndeterminate bool onwaar Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de voortgangsbalk onbepaald is. Als dit waar is, wordt waarde genegeerd.

BindableProgressBarValue

Een bindbare voortgangsbalkwaarde.

Vastgoed Typ Verplicht Beschrijving
BindingName touw true Hiermee kunt u de naam ophalen of instellen die overeenkomt met uw bindingswaarde.

Een logo dat moet worden weergegeven in plaats van het app-logo.

Vastgoed Typ Verplicht Beschrijving
bron touw true De URL naar de afbeelding. ms-appx, ms-appdata en http worden ondersteund. HTTP-afbeeldingen moeten 200 kB of kleiner zijn.
HintCrop ToastGenericAppLogoCrop onwaar Geef op hoe u de afbeelding wilt bijsnijden.
AlternateText touw onwaar Alternatieve tekst die de afbeelding beschrijft, die wordt gebruikt voor toegankelijkheidsdoeleinden.
AddImageQuery bool? onwaar Ingesteld op 'true' om Windows toe te staan een querytekenreeks toe te voegen aan de afbeeldings-URL die in de app-melding is opgegeven. Gebruik dit kenmerk als uw server als host fungeert voor afbeeldingen en queryreeksen kan verwerken, hetzij door een afbeeldingsvariabele op te halen op basis van de queryreeksen of door de queryreeks te negeren en de afbeelding te retourneren zoals opgegeven zonder de querytekenreeks. Deze querytekenreeks specificeert schaal, contrastinstelling en taal; De waarde 'www.website.com/images/hello.png' die in de melding wordt gegeven, wordt bijvoorbeeld 'www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us'

ToastGenericAppLogoCrop

Hiermee bepaalt u het bijsnijden van de afbeelding van het app-logo.

Waarde Meaning
standaard Bijsnijden maakt gebruik van het standaardgedrag van de renderer.
Geen Afbeelding wordt niet bijgesneden, weergegeven vierkant.
Circle Afbeelding wordt bijgesneden tot een cirkel.

ToastGenericHeroImage

Een aanbevolen 'hero'-afbeelding die wordt weergegeven op de pop-up en in het meldingencentrum.

Vastgoed Typ Verplicht Beschrijving
bron touw true De URL naar de afbeelding. ms-appx, ms-appdata en http worden ondersteund. HTTP-afbeeldingen moeten 200 kB of kleiner zijn.
AlternateText touw onwaar Alternatieve tekst die de afbeelding beschrijft, die wordt gebruikt voor toegankelijkheidsdoeleinden.
AddImageQuery bool? onwaar Stel in op 'true' om Windows toe te staan een querytekenreeks toe te voegen aan de afbeeldings-URL die is opgegeven in de app-melding. Gebruik dit kenmerk als uw server als host fungeert voor afbeeldingen en queryreeksen kan verwerken, hetzij door een afbeeldingsvariabele op te halen op basis van de queryreeksen of door de queryreeks te negeren en de afbeelding te retourneren zoals opgegeven zonder de querytekenreeks. Deze querytekenreeks specificeert schaal, contrastinstelling en taal; De waarde 'www.website.com/images/hello.png' die in de melding wordt gegeven, wordt bijvoorbeeld 'www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us'

ToastGenericAttributionText

De tekst van de naamsvermelding wordt onder aan de app-melding weergegeven.

Vastgoed Typ Verplicht Beschrijving
Text touw true De weer te geven tekst.
Taal touw onwaar De doellocatie van de visuele payload wanneer u gebruik maakt van gelokaliseerde resources, opgegeven als BCP-47-taaltags, zoals 'en-US' of 'fr-FR'. Indien niet opgegeven, wordt de landinstelling van het systeem gebruikt.

IToastActions

Markeringsinterface voor toast-acties/-invoer.

Implementaties
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

Implementeert IToastActions

Maak uw eigen aangepaste acties en invoer, met behulp van besturingselementen zoals knoppen, tekstvakken en selectie-invoer.

Vastgoed Typ Verplicht Beschrijving
Ingangen <IListIToastInput> onwaar Invoer zoals tekstvakken en selectie-invoer. Er zijn maximaal 5 invoerinvoeren toegestaan.
knoppen <IList> onwaar Knoppen worden weergegeven na alle invoer (of grenzend aan een invoer als de knop wordt gebruikt als een snelle antwoordknop). Er zijn slechts vijf knoppen toegestaan (of minder als u ook contextmenu-items hebt).
ContextMenuItems IList<ToastContextMenuItem> onwaar Aangepaste contextmenu-items, met aanvullende acties als de gebruiker met de rechtermuisknop op de melding klikt. U kunt maximaal vijf knoppen en contextmenu-items hebben gecombineerde.

IToastInput

Markerinterface voor toastinvoer.

Implementaties
ToastTextBox
ToastSelectionBox

ToastTextBox

Implementeert IToastInput

Een tekstvak waarin de gebruiker tekst kan typen.

Vastgoed Typ Verplicht Beschrijving
Id touw true De id is vereist en wordt gebruikt om de door de gebruiker ingevoerde tekst toe te wijzen aan een sleutel-waardepaar van id/waarde die uw app later gebruikt.
Titel touw onwaar Titeltekst die boven het tekstvak moet worden weergegeven.
PlaceholderContent touw onwaar Tijdelijke tekst die moet worden weergegeven in het tekstvak wanneer de gebruiker nog geen tekst heeft getypt.
DefaultInput touw onwaar De eerste tekst die in het tekstvak moet worden geplaatst. Laat deze null voor een leeg tekstvak staan.

ToastSelectionBox

Implementeert IToastInput

Een selectievak, waarmee gebruikers kunnen kiezen uit een vervolgkeuzelijst met opties.

Vastgoed Typ Verplicht Beschrijving
Id touw true De id is vereist. Als de gebruiker dit item heeft geselecteerd, wordt deze id teruggegeven aan de code van uw app, die aangeeft welke selectie ze hebben gekozen.
Content touw true Inhoud is vereist en is een tekenreeks die wordt weergegeven in het selectie-item.

ToastSelectionBoxItem

Een selectievakitem (een item dat de gebruiker kan selecteren in de vervolgkeuzelijst).

Vastgoed Typ Verplicht Beschrijving
Id touw true De id is vereist en wordt gebruikt om de door de gebruiker ingevoerde tekst toe te wijzen aan een sleutel-waardepaar van id/waarde die uw app later gebruikt.
Titel touw onwaar Titeltekst die boven het selectievak moet worden weergegeven.
DefaultSelectionBoxItemId touw onwaar Dit bepaalt welk item standaard is geselecteerd en verwijst naar de id-eigenschap van de ToastSelectionBoxItem. Als u dit niet opgeeft, is de standaardselectie leeg (gebruiker ziet niets).
Items IList<ToastSelectionBoxItem> onwaar De selectie-items waaruit de gebruiker kan kiezen in dit Selectievak. Er kunnen slechts 5 items worden toegevoegd.

IToastButton

Markeringsinterface voor toastknoppen.

Implementaties
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implementeert IToastButton

Een knop waarop de gebruiker kan klikken.

Vastgoed Typ Verplicht Beschrijving
Content touw true Verplicht. De tekst die op de knop moet worden weergegeven.
Argumenten touw true Verplicht. Door de app gedefinieerde reeks argumenten die de app later ontvangt als de gebruiker op deze knop klikt.
ActivationType ToastActivationType onwaar Hiermee bepaalt u welk type activering deze knop wordt gebruikt wanneer erop wordt geklikt. Standaard ingesteld op Voorgrond.
ActivationOptions ToastActivationOptions onwaar Hiermee kunt u extra opties ophalen of instellen met betrekking tot de activering van de toastknop.

ToastActivationType

Hiermee bepaalt u het type activering dat wordt gebruikt wanneer de gebruiker met een specifieke actie communiceert.

Waarde Meaning
Foreground Standaardwaarde. Uw voorgrond-app wordt gestart.
Achtergrond Uw bijbehorende achtergrondtaak (ervan uitgaande dat u alles instelt) wordt geactiveerd en u kunt code op de achtergrond uitvoeren (zoals het verzenden van het snelle antwoordbericht van de gebruiker) zonder de gebruiker te onderbreken.
Protocol Start een andere app met protocolactivering.

ToastActivationOptions

Aanvullende opties met betrekking tot activering.

Vastgoed Typ Verplicht Beschrijving
AfterActivationBehavior ToastAfterActivationBehavior onwaar Met deze functie haalt of wijzigt u het gedrag dat de melding moet hanteren wanneer de gebruiker deze actie aanroept. Dit werkt alleen op Desktop, voor ToastButton en ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn touw onwaar Als u ToastActivationType.Protocol gebruikt, kunt u desgewenst het PFN-doel opgeven, zodat ongeacht of meerdere apps zijn geregistreerd voor het afhandelen van dezelfde protocol-URI, uw gewenste app altijd wordt gestart.

ToastAfterActivationBehavior

Hiermee wordt het gedrag gespecificeerd dat de melding moet vertonen wanneer de gebruiker actie onderneemt op de melding.

Waarde Meaning
standaard Standaardgedrag. Het pop-upest wordt gesloten wanneer de gebruiker actie onderneemt op de pop-up.
PendingUpdate Nadat de gebruiker op een knop op uw toastmelding klikt, blijft de melding aanwezig, in een visuele bijwerkstatus In behandeling. Je moet je toast onmiddellijk bijwerken vanuit een achtergrondtaak, zodat de gebruiker de visuele status 'in behandeling' niet te lang ziet.

ToastButtonSnooze

Implementeert IToastButton

Een door het systeem afgehandelde uitstellen knop die automatisch het uitstellen van de melding afhandelt.

Vastgoed Typ Verplicht Beschrijving
CustomContent touw onwaar Optionele aangepaste tekst die wordt weergegeven op de knop die de standaard gelokaliseerde tekst 'Uitstellen' overschrijft.

ToastButtonDismiss

Implementeert IToastButton

Een door het systeem afgehandelde knop Sluiten waarmee de melding wordt gesloten wanneer erop wordt geklikt.

Vastgoed Typ Verplicht Beschrijving
CustomContent touw onwaar Optionele aangepaste tekst die wordt weergegeven op de knop die de standaard gelokaliseerde tekst 'Negeren' overschrijft.

ToastActionsSnoozeAndDismiss

*Implementeert IToastActions

Hiermee wordt automatisch een selectievak gemaakt voor uitstelintervallen en knoppen voor snoozen/sluiten, allemaal automatisch gelokaliseerd, en de uitstellogica wordt automatisch door het systeem afgehandeld.

Vastgoed Typ Verplicht Beschrijving
ContextMenuItems IList<ToastContextMenuItem> onwaar Aangepaste contextmenu-items, met aanvullende acties als de gebruiker met de rechtermuisknop op de melding klikt. U kunt maximaal vijf items hebben.

ToastContextMenuItem

Een item in het contextmenu.

Vastgoed Typ Verplicht Beschrijving
Content touw true Verplicht. De weer te geven tekst.
Argumenten touw true Verplicht. Door de app gedefinieerde reeks argumenten die de app later kan ophalen zodra deze is geactiveerd wanneer de gebruiker op het menu-item klikt.
ActivationType ToastActivationType onwaar Hiermee bepaalt u welk type activering dit menu-item wordt gebruikt wanneer erop wordt geklikt. Standaard ingesteld op Voorgrond.
ActivationOptions ToastActivationOptions onwaar Aanvullende opties met betrekking tot de activering van het contextmenu-item voor de pop-up.

ToastAudio

Geef audio op die moet worden afgespeeld wanneer de app-melding wordt ontvangen.

Vastgoed Typ Verplicht Beschrijving
Src URI onwaar Het mediabestand dat moet worden afgespeeld in plaats van het standaardgeluid. Alleen ms-appx en ms-resource worden ondersteund. Alle andere (ms-appdata, http, C:, enzovoort) worden niet ondersteund.
Loop booleaan onwaar Ingesteld op true als het geluid herhaald moet worden zolang de melding wordt weergegeven; false om slechts één keer af te spelen (standaard).
Stil booleaan onwaar Zet op True om het geluid te dempen; False om toe te staan dat het geluid van de app-melding wordt afgespeeld (standaard).

ToastHeader

Een aangepaste header waarmee meerdere meldingen worden gegroepeerd in het Meldingencentrum.

Vastgoed Typ Verplicht Beschrijving
Id touw true Een door ontwikkelaars gemaakte id die deze header uniek identificeert. Als twee meldingen dezelfde header-id hebben, worden deze weergegeven onder dezelfde koptekst in het meldingencentrum.
Titel touw true Een titel voor de koptekst.
Argumenten touw true Hiermee haalt u een door de ontwikkelaar gedefinieerde tekenreeks met argumenten op of stelt u deze in, die naar de app wordt geretourneerd wanneer de gebruiker op deze koptekst klikt. Kan niet null zijn.
ActivationType ToastActivationType onwaar Hiermee wordt het type activering opgehaald of ingesteld dat door deze header wordt gebruikt wanneer erop wordt geklikt. Standaard ingesteld op Voorgrond. Houd er rekening mee dat alleen Voorgrond en Protocol worden ondersteund.
ActivationOptions ToastActivationOptions onwaar Hiermee haalt u extra opties op of stelt u deze in met betrekking tot de activering van de toastkop.
  • Last updated on