Freigeben über

App-Benachrichtigungsinhaltsschema

Im Folgenden werden alle Eigenschaften und Elemente in den Toast-Inhalten beschrieben.

Wenn Sie lieber unformatierte XML anstelle der Windows App SDK Builder-APIs verwenden möchten, lesen Sie the XML-Schema.

ToastContent

ToastContent

ToastContent ist das Objekt der obersten Ebene, das den Inhalt einer Benachrichtigung beschreibt, einschließlich visueller Elemente, Aktionen und Audio.

Eigentum Typ Erforderlich Beschreibung
Launch Schnur FALSCH Eine Zeichenfolge, die an die Anwendung übergeben wird, wenn sie durch den Toast aktiviert wird. Das Format und der Inhalt dieser Zeichenfolge werden von der App für die eigene Verwendung definiert. Wenn der Benutzer auf den Toast tippt oder klickt, um die zugehörige App zu starten, stellt die Startzeichenfolge den Kontext für die App bereit, der es ermöglicht, dem Benutzer eine Ansicht anzuzeigen, die für den Toast-Inhalt relevant ist, anstatt in der Standardart zu starten.
Visual ToastVisual STIMMT Beschreibt den visuellen Teil der App-Benachrichtigung.
Aktionen IToastActions FALSCH Erstellen Sie optional benutzerdefinierte Aktionen mit Schaltflächen und Eingaben.
Audio ToastAudio FALSCH Beschreibt den Audioteil der App-Benachrichtigung.
ActivationType ToastActivationType FALSCH Gibt an, welcher Aktivierungstyp verwendet wird, wenn der Benutzer auf den Textkörper dieses Popups klickt.
ActivationOptions ToastActivationOptions FALSCH Zusätzliche Optionen für die Aktivierung der App-Benachrichtigung.
Szenario ToastScenario FALSCH Deklariert das Szenario, für das die Benachrichtigung verwendet wird, z. B. einen Alarm oder eine Erinnerung.
DisplayTimestamp DateTimeOffset? FALSCH Überschreiben Sie den Standardzeitstempel mit einem benutzerdefinierten Zeitstempel, der angibt, wann der Benachrichtigungsinhalt tatsächlich übermittelt wurde, anstatt zu dem Zeitpunkt, zu dem die Benachrichtigung von der Windows-Plattform empfangen wurde.
Header ToastHeader FALSCH Fügen Sie Ihrer Benachrichtigung einen benutzerdefinierten Header hinzu, um mehrere Benachrichtigungen im Benachrichtigungscenter zu gruppieren.

ToastScenario

Gibt an, welches Szenario die Toast-Benachrichtigung darstellt.

Wert Bedeutung
Vorgabe Das normale Verhalten von Toast-Benachrichtigungen.
Reminder Eine Erinnerungsbenachrichtigung. Dies wird vorab erweitert angezeigt und bleibt auf dem Bildschirm des Benutzers, bis es geschlossen wird.
Alarm Eine Alarmbenachrichtigung. Dies wird vorab erweitert angezeigt und bleibt auf dem Bildschirm des Benutzers, bis es geschlossen wird. Audio wird standardmäßig in einer Schleife wiedergegeben und verwendet Alarmaudio.
IncomingCall Eine Benachrichtigung über eingehende Anrufe. Dies wird in einem speziellen Anzeigenformat vorab erweitert angezeigt und bleibt auf dem Bildschirm des Benutzers, bis sie geschlossen wird. Audio wird standardmäßig in einer Schleife wiedergegeben und verwendet Klingeltonaudio.

ToastVisual

Der visuelle Teil von Toast-Benachrichtigungen enthält die Bindungen, die Text, Bilder, adaptive Inhalte und mehr umfassen.

Eigentum Typ Erforderlich Beschreibung
BindingGeneric ToastBindingGeneric STIMMT Die generische Toast-Bindung, die auf allen Geräten gerendert werden kann. Diese Bindung ist erforderlich und darf nicht null sein.
BaseUri Uri FALSCH Eine Standardbasis-URL, die mit relativen URLs in Bildquellenattributen kombiniert wird.
AddImageQuery bool? FALSCH Legen Sie den Wert auf "true" fest, damit Windows eine Abfragezeichenfolge an die in der App-Benachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und Abfragezeichenfolgen verarbeiten kann, entweder durch Abrufen einer Bildvariante basierend auf den Abfragezeichenfolgen oder durch Ignorieren der Abfragezeichenfolge und Zurückgeben des Bilds wie angegeben ohne die Abfragezeichenfolge. Diese Abfragezeichenfolge gibt Skalierung, Kontrasteinstellung und Sprache an; beispielsweise wird ein gegebener Wert von "www.website.com/images/hello.png" in der Benachrichtigung zu "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".
Sprache Schnur FALSCH Das Zielgebiet der visuellen Nutzlast bei Verwendung lokalisierter Ressourcen, angegeben als BCP-47-Sprachkennzeichnungen wie "en-US" oder "fr-FR". Dieses Gebietsschema wird durch jedes Gebietsschema überschrieben, das durch Bindung oder Text angegeben ist. Wenn nicht angegeben, wird stattdessen das Systemgebietsschema verwendet.

ToastBindingGeneric

Die generische Zuordnung ist die Standardbindung für Toast-Benachrichtigungen. Hier geben Sie den Text, die Bilder, den adaptiven Inhalt und mehr an.

Eigentum Typ Erforderlich Beschreibung
Kinder IList<IToastBindingGenericChild> FALSCH Der Inhalt der Toast-Benachrichtigung, der Text, Bilder und Gruppen enthalten kann. Textelemente müssen vor allen anderen Elementen stehen, und nur drei Textelemente werden unterstützt. Wenn ein Textelement nach einem anderen Element platziert wird, wird es entweder nach oben verschoben oder an eine niedrigere Position versetzt. Und schließlich werden bestimmte Texteigenschaften wie HintStyle für die untergeordneten Stammtextelemente nicht unterstützt und funktionieren nur innerhalb einer AdaptiveSubgroup.
AppLogoOverride ToastGenericAppLogo FALSCH Ein optionales Logo, um das App-Logo zu ersetzen.
HeroImage ToastGenericHeroImage FALSCH Ein optionales "Hero"-Bild, das auf dem Toast und in der Benachrichtigungszentrale angezeigt wird.
Attribution ToastGenericAttributionText FALSCH Optionaler Zuschreibungstext, der unten in der App-Benachrichtigung angezeigt wird.
BaseUri Uri FALSCH Eine Standardbasis-URL, die mit relativen URLs in Bildquellenattributen kombiniert wird.
AddImageQuery bool? FALSCH Legen Sie den Wert auf "true" fest, damit Windows eine Abfragezeichenfolge an die in der App-Benachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und Abfragezeichenfolgen verarbeiten kann, entweder durch Abrufen einer Bildvariante basierend auf den Abfragezeichenfolgen oder durch Ignorieren der Abfragezeichenfolge und Zurückgeben des Bilds wie angegeben ohne die Abfragezeichenfolge. Diese Abfragezeichenfolge gibt Skalierung, Kontrasteinstellung und Sprache an; beispielsweise wird ein gegebener Wert von "www.website.com/images/hello.png" in der Benachrichtigung zu "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".
Sprache Schnur FALSCH Das Zielgebiet der visuellen Nutzlast bei Verwendung lokalisierter Ressourcen, angegeben als BCP-47-Sprachkennzeichnungen wie "en-US" oder "fr-FR". Dieses Gebietsschema wird durch jedes Gebietsschema überschrieben, das durch Bindung oder Text angegeben ist. Wenn nicht angegeben, wird stattdessen das Systemgebietsschema verwendet.

IToastBindingGenericChild

Markierungsschnittstelle für Toast-Kindelemente, die Text, Bilder, Gruppen und mehr enthalten.

Ausführungen
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

Ein adaptives Textelement. Wenn in der obersten Ebene ToastBindingGeneric.Children platziert wird, werden nur HintMaxLines angewendet. Wenn dies jedoch als untergeordnetes Element einer Gruppe/Untergruppe platziert wird, wird die Volltextformatierung unterstützt.

Eigentum Typ Erforderlich Beschreibung
Text Zeichenfolge oder BindableString FALSCH Der anzuzeigende Text. Die Datenbindung funktioniert nur für Textelemente der obersten Ebene.
HintStyle AdaptiveTextStyle FALSCH Die Formatvorlage steuert die Schriftgröße, das Gewicht und die Deckkraft des Texts. Funktioniert nur für Textelemente innerhalb einer Gruppe/Untergruppe.
HintWrap bool? FALSCH Setzen Sie diese Option auf "true", um den Zeilenumbruch zu aktivieren. Textelemente der obersten Ebene ignorieren diese Eigenschaft und werden immer umbrochen (Sie können HintMaxLines = 1 verwenden, um das Umbrechen für Textelemente der obersten Ebene zu deaktivieren). Textelemente innerhalb von Gruppen/Untergruppen werden standardmäßig auf "false" für den Umbruch festgelegt.
HintMaxLines int? FALSCH Die maximale Anzahl von Zeilen, die das Textelement anzeigen darf.
HintMinLines int? FALSCH Die Mindestanzahl der Zeilen, die das Textelement anzeigen muss. Funktioniert nur für Textelemente innerhalb einer Gruppe/Untergruppe.
HintAlign AdaptiveTextAlign FALSCH Die horizontale Ausrichtung des Textes. Funktioniert nur für Textelemente innerhalb einer Gruppe/Untergruppe.
Sprache Schnur FALSCH Das Zielgebietsschema der XML-Nutzlast, angegeben als BCP-47-Sprachtags wie "en-US" oder "fr-FR". Das hier angegebene Gebietsschema überschreibt alle anderen angegebenen Gebietsschemas, wie etwa die in Bindungen oder visuellen Elementen. Wenn dieser Wert eine Literalzeichenfolge ist, wird dieses Attribut standardmäßig auf die Benutzeroberflächensprache des Benutzers festgelegt. Wenn dieser Wert ein Zeichenfolgenverweis ist, wird dieses Attribut standardmäßig auf das Gebietsschema festgelegt, das von Windows-Runtime bei der Auflösung der Zeichenfolge ausgewählt wurde.

BindableString

Ein Bindungswert für Zeichenfolgen.

Eigentum Typ Erforderlich Beschreibung
BindingName Schnur STIMMT Ruft den Namen ab, der Ihrem Bindungsdatenwert zugeordnet ist, oder legt diesen fest.

AdaptiveTextStyle

Textformat steuert Schriftgröße, Schriftstärke und Deckkraft. Subtile Opazität beträgt 60% Deckkraft.

Wert Bedeutung
Vorgabe Standardwert. Der Stil wird vom Renderer bestimmt.
Beschriftung Kleiner als der Schriftgrad des Absatzes.
CaptionSubtle Identisch wie die Beschriftung, jedoch mit dezenter Transparenz.
Körper Schriftgrad des Absatzes.
BodySubtle Identisch mit dem Hauptteil, aber mit subtiler Deckkraft.
Base Schriftgröße des Absatzes, Fettschrift. Im Wesentlichen die fett dargestellte Version von "Body".
BaseSubtle Ähnlich wie die Basis, jedoch mit leicht erhöhter Transparenz.
Subtitle H4 Schriftgröße.
SubtitleSubtle Gleich wie Untertitel, aber mit subtiler Deckkraft.
Title H3 Schriftgröße.
TitleSubtle Identisch mit Titel, aber mit einer subtilen Deckkraft.
TitleNumeral Identisch mit dem „Titel“, jedoch ohne oberen/unteren Innenabstand.
Subheader H2-Schriftgröße.
SubheaderSubtle Identisch mit Unterüberschrift, aber mit subtiler Deckkraft.
SubheaderNumeral Gleich wie die Unterüberschrift, aber ohne oberen und unteren Abstand.
Header H1-Schriftgröße
HeaderSubtle Identisch mit dem Header, aber mit dezenter Transparenz.
HeaderNumeral Identisch mit dem Header, aber ohne oberen und unteren Abstand.

AdaptiveTextAlign

Steuert die horizontale Ausrichtung von Text.

Wert Bedeutung
Vorgabe Standardwert. Die Ausrichtung wird automatisch vom Renderer bestimmt.
Auto Die Ausrichtung wird durch die aktuelle Sprache und Kultur bestimmt.
Left Richten Sie den Text horizontal nach links aus.
Center Richten Sie den Text horizontal in der Mitte aus.
Rechts Richten Sie den Text horizontal rechts aus.

AdaptiveImage

Ein eingebettetes Bild.

Eigentum Typ Erforderlich Beschreibung
Quelle Schnur STIMMT Die URL zum Bild. ms-appx, ms-appdata und http werden unterstützt. Webbilder können bis zu 3 MB für normale Verbindungen und 1 MB bei getakteten Verbindungen sein.
HintCrop AdaptiveImageCrop FALSCH Steuern Sie den gewünschten Zuschnitt des Bilds.
HintRemoveMargin bool? FALSCH Standardmäßig weisen Bilder innerhalb von Gruppen/Untergruppen einen 8px-Rand um sie herum auf. Sie können diesen Rand entfernen, indem Sie diese Eigenschaft auf "true" festlegen.
HintAlign AdaptiveImageAlign FALSCH Die horizontale Ausrichtung des Bilds. Funktioniert nur für Bilder innerhalb einer Gruppe/Untergruppe.
AlternateText Schnur FALSCH Alternativer Text zur Beschreibung des Bilds, der für Barrierefreiheitszwecke verwendet wird.
AddImageQuery bool? FALSCH Legen Sie den Wert auf "true" fest, damit Windows eine Abfragezeichenfolge an die in der App-Benachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und Abfragezeichenfolgen verarbeiten kann, entweder durch Abrufen einer Bildvariante basierend auf den Abfragezeichenfolgen oder durch Ignorieren der Abfragezeichenfolge und Zurückgeben des Bilds wie angegeben ohne die Abfragezeichenfolge. Diese Abfragezeichenfolge gibt Skalierung, Kontrasteinstellung und Sprache an; beispielsweise wird ein gegebener Wert von "www.website.com/images/hello.png" in der Benachrichtigung zu "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".

AdaptiveImageCrop

Gibt den gewünschten Zuschnitt des Bilds an.

Wert Bedeutung
Vorgabe Standardwert. Das Zuschneideverhalten wird durch den Renderer bestimmt.
None Das Bild ist nicht beschnitten.
Circle Das Bild wird auf eine Kreisform zugeschnitten.

AdaptiveImageAlign

Gibt die horizontale Ausrichtung für ein Bild an.

Wert Bedeutung
Vorgabe Standardwert. Vom Renderer festgelegtes Ausrichtungsverhalten.
Stretch Das Bild wird gestreckt, um die verfügbare Breite zu füllen (und möglicherweise auch die verfügbare Höhe, abhängig davon, wo das Bild platziert wird).
Left Richten Sie das Bild linksbündig aus, wobei das Bild in seiner nativen Auflösung angezeigt wird.
Center Richten Sie das Bild horizontal in der Mitte aus, wobei das Bild in seiner systemeigenen Auflösung angezeigt wird.
Rechts Richten Sie das Bild rechtsbündig aus, sodass es in seiner nativen Auflösung angezeigt wird.

AdaptiveGroup

Gruppen identifizieren semantisch, dass der Inhalt in der Gruppe entweder als Ganzes angezeigt werden muss oder nicht angezeigt werden muss, wenn er nicht passt. Gruppen ermöglichen auch das Erstellen mehrerer Spalten.

Eigentum Typ Erforderlich Beschreibung
Kinder IList<AdaptiveSubgroup> FALSCH Untergruppen werden als vertikale Spalten angezeigt. Sie müssen Untergruppen verwenden, um Inhalte in einer AdaptiveGroup bereitzustellen.

AdaptiveSubgroup

Untergruppen sind vertikale Spalten, die Text und Bilder enthalten können.

Eigentum Typ Erforderlich Beschreibung
Kinder IList<IAdaptiveSubgroupChild> FALSCH AdaptiveText und AdaptiveImage sind gültige Unterelemente von Untergruppen.
HintWeight int? FALSCH Steuern Sie die Breite dieser Untergruppenspalte, indem Sie die Gewichtung im Verhältnis zu den anderen Untergruppen angeben.
HintTextStacking AdaptiveSubgroupTextStacking FALSCH Steuern Sie die vertikale Ausrichtung des Inhalts dieser Untergruppe.

IAdaptiveSubgroupChild

Markierungsschnittstelle für Untergruppen-Kinder.

Ausführungen
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking gibt die vertikale Ausrichtung des Inhalts an.

Wert Bedeutung
Vorgabe Standardwert. Renderer wählt automatisch die vertikale Standardausrichtung aus.
Top Vertikal nach oben ausrichten.
Center Vertikal zur Mitte ausrichten.
Unten Vertikal am unteren Rand ausrichten.

AdaptiveProgressBar

Ein Fortschrittsbalken. Wird nur auf Desktop unterstützt.

Eigentum Typ Erforderlich Beschreibung
Title Zeichenfolge oder BindableString FALSCH Kann eine optionale Titelzeichenfolge abrufen oder festlegen. Unterstützt die Datenbindung.
Wert Doppel oder AdaptiveProgressBarValue oder BindableProgressBarValue FALSCH Ermöglicht das Abrufen oder Festlegen des Werts des Fortschrittsbalkens. Unterstützt die Datenbindung. Standardmäßig auf 0 gesetzt.
ValueStringOverride Zeichenfolge oder BindableString FALSCH Dient zum Abrufen oder Festlegen einer optionalen Zeichenfolge, die anstelle der standardprozentigen Zeichenfolge angezeigt werden soll. Wenn dies nicht angegeben wird, wird so etwas wie "70%" angezeigt.
Status Zeichenfolge oder BindableString STIMMT Dient zum Abrufen oder Festlegen einer Statuszeichenfolge (erforderlich), die unter dem Fortschrittsbalken auf der linken Seite angezeigt wird. Diese Zeichenfolge sollte den Status des Vorgangs widerspiegeln, z. B. "Herunterladen..." oder "Installieren..."

AdaptiveProgressBarValue

Eine Klasse, die den Wert des Fortschrittsbalkens darstellt.

Eigentum Typ Erforderlich Beschreibung
Wert doppelt FALSCH Dient zum Abrufen oder Festlegen des Werts (0,0 - 1,0), der den abgeschlossenen Prozentsatz darstellt.
IsIndeterminate bool FALSCH Legt fest oder gibt an, ob der Fortschrittsbalken unbestimmt ist. Wenn dies zutrifft, wird der Wert ignoriert.

BindableProgressBarValue

Ein bindbarer Fortschrittsbalkenwert.

Eigentum Typ Erforderlich Beschreibung
BindingName Schnur STIMMT Ruft den Namen ab, der Ihrem Bindungsdatenwert zugeordnet ist, oder legt diesen fest.

Ein Logo, das anstelle des App-Logos angezeigt werden soll.

Eigentum Typ Erforderlich Beschreibung
Quelle Schnur STIMMT Die URL zum Bild. ms-appx, ms-appdata und http werden unterstützt. HTTP-Bilder müssen maximal 200 KB groß sein.
HintCrop ToastGenericAppLogoCrop FALSCH Geben Sie an, wie das Bild zugeschnitten werden soll.
AlternateText Schnur FALSCH Alternativer Text zur Beschreibung des Bilds, der für Barrierefreiheitszwecke verwendet wird.
AddImageQuery bool? FALSCH Legen Sie den Wert auf "true" fest, damit Windows eine Abfragezeichenfolge an die in der App-Benachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und Abfragezeichenfolgen verarbeiten kann, entweder durch Abrufen einer Bildvariante basierend auf den Abfragezeichenfolgen oder durch Ignorieren der Abfragezeichenfolge und Zurückgeben des Bilds wie angegeben ohne die Abfragezeichenfolge. Diese Abfragezeichenfolge gibt Skalierung, Kontrasteinstellung und Sprache an; beispielsweise wird ein gegebener Wert von "www.website.com/images/hello.png" in der Benachrichtigung zu "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".

ToastGenericAppLogoCrop

Steuert das Zuschneiden des App-Logobilds.

Wert Bedeutung
Vorgabe Beim Zuschneiden wird das Standardverhalten des Renderers verwendet.
None Bild ist nicht zugeschnitten, sondern wird quadratisch angezeigt.
Circle Das Bild ist in Form eines Kreises zugeschnitten.

ToastGenericHeroImage

Ein empfohlenes "Hero"-Bild, das in der Toast-Nachricht und im Info-Center angezeigt wird.

Eigentum Typ Erforderlich Beschreibung
Quelle Schnur STIMMT Die URL zum Bild. ms-appx, ms-appdata und http werden unterstützt. HTTP-Bilder müssen maximal 200 KB groß sein.
AlternateText Schnur FALSCH Alternativer Text zur Beschreibung des Bilds, der für Barrierefreiheitszwecke verwendet wird.
AddImageQuery bool? FALSCH Legen Sie den Wert auf "true" fest, damit Windows eine Abfragezeichenfolge an die in der App-Benachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und Abfragezeichenfolgen verarbeiten kann, entweder durch Abrufen einer Bildvariante basierend auf den Abfragezeichenfolgen oder durch Ignorieren der Abfragezeichenfolge und Zurückgeben des Bilds wie angegeben ohne die Abfragezeichenfolge. Diese Abfragezeichenfolge gibt Skalierung, Kontrasteinstellung und Sprache an; beispielsweise wird ein gegebener Wert von "www.website.com/images/hello.png" in der Benachrichtigung zu "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".

ToastGenericAttributionText

Zuschreibungstext, der unten in der App-Benachrichtigung angezeigt wird.

Eigentum Typ Erforderlich Beschreibung
Text Schnur STIMMT Der anzuzeigende Text.
Sprache Schnur FALSCH Das Zielgebiet der visuellen Nutzlast bei Verwendung lokalisierter Ressourcen, angegeben als BCP-47-Sprachkennzeichnungen wie "en-US" oder "fr-FR". Wenn nicht angegeben, wird stattdessen das Systemgebietsschema verwendet.

IToastActions

Markierungsschnittstelle für Toast-Aktionen/Toasteingaben.

Ausführungen
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

Implementiert IToastActions

Erstellen Sie eigene benutzerdefinierte Aktionen und Eingaben, indem Sie Steuerelemente wie Schaltflächen, Textfelder und Auswahleingaben verwenden.

Eigentum Typ Erforderlich Beschreibung
Eingaben IList<IToastInput> FALSCH Eingaben wie Textfelder und Auswahleingaben. Es sind nur bis zu 5 Eingaben zulässig.
Tasten IList<IToastButton> FALSCH Schaltflächen werden nach allen Eingaben angezeigt (oder neben einer Eingabe, wenn die Schaltfläche als Schaltfläche für schnelle Antwort verwendet wird). Es sind nur bis zu 5 Schaltflächen zulässig (oder weniger, wenn Sie auch Über Kontextmenüelemente verfügen).
ContextMenuItems IList<ToastContextMenuItem> FALSCH Benutzerdefinierte Kontextmenüelemente, die zusätzliche Aktionen bereitstellen, wenn der Benutzer mit der rechten Maustaste auf die Benachrichtigung klickt. Sie können insgesamt nur 5 Schaltflächen und Kontextmenüelemente kombinierthaben.

IToastInput

Marker-Interface für Toast-Eingaben.

Ausführungen
ToastTextBox
ToastSelectionBox

ToastTextBox

Implementiert IToastInput

Ein Textfeld-Steuerelement, in das der Benutzer Text eingeben kann.

Eigentum Typ Erforderlich Beschreibung
ID Schnur STIMMT Die ID ist erforderlich und wird verwendet, um den vom Benutzer eingegebenen Text einem Schlüssel-Wert-Paar aus ID und Wert zuzuordnen, das Ihre App später verarbeitet.
Title Schnur FALSCH Titeltext, der über dem Textfeld angezeigt werden soll.
PlaceholderContent Schnur FALSCH Platzhaltertext, der im Textfeld angezeigt werden soll, wenn der Benutzer noch keinen Text eingegeben hat.
DefaultInput Schnur FALSCH Der anfängliche Text, der im Textfeld platziert werden soll. Lassen Sie diesen Wert auf Null für ein leeres Textfeld.

ToastSelectionBox

Implementiert IToastInput

Ein Auswahlfeld-Steuerelement, mit dem Benutzer aus einer Dropdownliste mit Optionen auswählen können.

Eigentum Typ Erforderlich Beschreibung
ID Schnur STIMMT Die ID ist erforderlich. Wenn der Benutzer dieses Element ausgewählt hat, wird diese ID zurück an den Code Ihrer App übergeben, der angibt, welche Auswahl sie ausgewählt hat.
Inhalt Schnur STIMMT Der Inhalt ist erforderlich und es handelt sich um eine Zeichenfolge, die im Auswahlfeld angezeigt wird.

ToastSelectionBoxItem

Ein Auswahlfeldelement (ein Element, das der Benutzer in der Dropdownliste auswählen kann).

Eigentum Typ Erforderlich Beschreibung
ID Schnur STIMMT Die ID ist erforderlich und wird verwendet, um den vom Benutzer eingegebenen Text einem Schlüssel-Wert-Paar aus ID und Wert zuzuordnen, das Ihre App später verarbeitet.
Title Schnur FALSCH Titeltext, der über dem Auswahlfeld angezeigt werden soll.
DefaultSelectionBoxItemId Schnur FALSCH Die Eigenschaft steuert, welches Element standardmäßig ausgewählt ist, und verweist auf die ID des ToastSelectionBoxItem. Wenn Sie dies nicht angeben, ist die Standardauswahl leer (Der Benutzer sieht nichts).
Elemente IList<ToastSelectionBoxItem-> FALSCH Die Auswahlelemente, die der Benutzer in dieser Auswahlbox wählen kann. Es können nur fünf Elemente hinzugefügt werden.

IToastButton

Markierungsschnittstelle für Toast-Schaltflächen.

Ausführungen
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implementiert IToastButton

Eine Schaltfläche, auf die der Benutzer klicken kann.

Eigentum Typ Erforderlich Beschreibung
Inhalt Schnur STIMMT Erforderlich. Der Text, der auf der Schaltfläche angezeigt werden soll.
Argumente Schnur STIMMT Erforderlich. App-definierte Zeichenfolge von Argumenten, die die App später empfängt, wenn der Benutzer auf diese Schaltfläche klickt.
ActivationType ToastActivationType FALSCH Steuert, welche Art von Aktivierung diese Schaltfläche verwendet, wenn darauf geklickt wird. Die Voreinstellung ist "Vordergrund".
ActivationOptions ToastActivationOptions FALSCH Ruft zusätzliche Optionen für die Aktivierung der Toast-Schaltfläche ab oder legt diese fest.

ToastActivationType

Bestimmt den Aktivierungstyp, der verwendet wird, wenn der Benutzer mit einer bestimmten Aktion interagiert.

Wert Bedeutung
Foreground Standardwert. Ihre Vordergrundanwendung ist gestartet.
Hintergrund Die entsprechende Hintergrundaufgabe (vorausgesetzt, Sie haben alles eingerichtet) wird ausgelöst, und Sie können Code im Hintergrund ausführen (z. B. senden der Schnellantwortnachricht des Benutzers), ohne den Benutzer zu unterbrechen.
Protokoll Starten Sie eine andere App mithilfe der Protokollaktivierung.

ToastActivationOptions

Zusätzliche Optionen für die Aktivierung.

Eigentum Typ Erforderlich Beschreibung
AfterActivationBehavior ToastAfterActivationBehavior FALSCH Ruft ab oder legt das Verhalten fest, das das Popup verwenden soll, wenn der Benutzer diese Aktion aufruft. Das funktioniert nur auf dem Desktop, für ToastButton und ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn Schnur FALSCH Wenn Sie ToastActivationType.Protocolverwenden, können Sie optional den Ziel-PFN angeben, damit unabhängig davon, ob mehrere Apps registriert sind, um denselben Protokoll-URI zu verarbeiten, Ihre gewünschte App immer gestartet wird.

ToastAfterActivationBehavior

Gibt das Verhalten an, das die Toast-Benachrichtigung verwenden soll, wenn der Benutzer darauf reagiert.

Wert Bedeutung
Vorgabe Standardverhalten. Das Toast wird geschlossen, wenn der Benutzer eine Aktion auf das Toast ausführt.
PendingUpdate Nachdem der Benutzer auf eine Schaltfläche in Ihrem Toast geklickt hat, bleibt die Benachrichtigung in einem visuellen Zustand "ausstehende Aktualisierung" vorhanden. Sie sollten den Toast sofort aus einer Hintergrundaufgabe aktualisieren, damit der Benutzer diesen visuellen Zustand "Ausstehendes Update" nicht zu lange sieht.

ToastButtonSnooze

Implementiert IToastButton

Eine vom System verwaltete Schlummertaste, die das Schlummern der Benachrichtigung automatisch übernimmt.

Eigentum Typ Erforderlich Beschreibung
CustomContent Schnur FALSCH Optionaler benutzerdefinierter Text, der auf der Schaltfläche angezeigt wird und den lokalisierten Standardtext "Snooze" überschreibt.

ToastButtonDismiss

Implementiert IToastButton

Eine vom System verarbeitete Schaltfläche zum Schließen, die die Benachrichtigung schließt, wenn auf sie geklickt wird.

Eigentum Typ Erforderlich Beschreibung
CustomContent Schnur FALSCH Optionaler benutzerdefinierter Text, der auf der Schaltfläche angezeigt wird, die den lokalisierten Standardtext "Schließen" überschreibt.

ToastActionsSnoozeAndDismiss

*Implementiert IToastActions

Erstellt automatisch ein Auswahlfeld für Schlummerintervalle und Schaltflächen zum Erinnern/Verschieben, die alle automatisch lokalisiert werden; die Erinnerungslogik wird ebenfalls automatisch vom System gehandhabt.

Eigentum Typ Erforderlich Beschreibung
ContextMenuItems IList<ToastContextMenuItem> FALSCH Benutzerdefinierte Kontextmenüelemente, die zusätzliche Aktionen bereitstellen, wenn der Benutzer mit der rechten Maustaste auf die Benachrichtigung klickt. Sie können nur bis zu 5 Elemente haben.

ToastContextMenuItem

Ein Kontextmenüelementeintrag.

Eigentum Typ Erforderlich Beschreibung
Inhalt Schnur STIMMT Erforderlich. Der anzuzeigende Text.
Argumente Schnur STIMMT Erforderlich. App-definierte Zeichenfolge von Argumenten, die die App später abrufen kann, nachdem sie aktiviert wurde, wenn der Benutzer auf das Menüelement klickt.
ActivationType ToastActivationType FALSCH Steuert, welche Art der Aktivierung dieses Menüelements verwendet wird, wenn darauf geklickt wird. Die Voreinstellung ist "Vordergrund".
ActivationOptions ToastActivationOptions FALSCH Zusätzliche Optionen zur Aktivierung des Kontextmenüelements der Toastbenachrichtigung.

ToastAudio

Geben Sie das Audio an, das wiedergegeben werden soll, wenn die App-Benachrichtigung empfangen wird.

Eigentum Typ Erforderlich Beschreibung
Src URI FALSCH Die Mediendatei, die statt des Standardsounds abgespielt werden soll. Es werden nur ms-appx und ms-resource unterstützt. Alle anderen (ms-appdata, http, C:, etc.) werden nicht unterstützt.
Loop boolean FALSCH Auf "true" festlegen, wenn der Sound so lange wiederholt werden soll, wie die Toast-Benachrichtigung angezeigt wird; auf "false" setzen, um ihn nur einmal abzuspielen (Standardeinstellung).
Silent boolean FALSCH True, um den Sound stummzuschalten; false, um die Wiedergabe des App-Benachrichtigungssounds zuzulassen (Standardeinstellung).

ToastHeader

Ein benutzerdefinierter Header, der mehrere Benachrichtigungen innerhalb des Benachrichtigungscenters gruppiert.

Eigentum Typ Erforderlich Beschreibung
ID Schnur STIMMT Ein vom Entwickler erstellter Bezeichner, der diesen Header eindeutig identifiziert. Wenn zwei Benachrichtigungen dieselbe Kopfzeilen-ID haben, werden sie unter demselben Header im Benachrichtigungscenter angezeigt.
Title Schnur STIMMT Ein Titel für die Kopfzeile.
Argumente Schnur STIMMT Dient zum Abrufen oder Festlegen einer entwicklerdefinierten Zeichenfolge von Argumenten, die an die App zurückgegeben werden, wenn der Benutzer auf diese Kopfzeile klickt. Darf nicht null sein.
ActivationType ToastActivationType FALSCH Ruft den Aktivierungstyp ab, den dieser Header verwendet, wenn darauf geklickt wird, oder legt diesen fest. Die Voreinstellung ist "Vordergrund". Beachten Sie, dass nur Vordergrund und Protokoll unterstützt werden.
ActivationOptions ToastActivationOptions FALSCH Ruft zusätzliche Optionen für die Aktivierung des Toast-Headers ab oder legt diese fest.
  • Last updated on