PopupinhaltToast content

Mithilfe von adaptiven und interaktiven Popup Benachrichtigungen können Sie flexible Benachrichtigungen mit Text, Bildern und Schaltflächen/Eingaben erstellen.Adaptive and interactive toast notifications let you create flexible notifications with text, images, and buttons/inputs.

Wichtige APIs: NuGet-Paket für UWP-Community-Toolkit-BenachrichtigungenImportant APIs: UWP Community Toolkit Notifications nuget package

Hinweis

Die Legacy Vorlagen aus Windows 8.1 und Windows Phone 8,1 finden Sie im Katalog mit der Legacy-Popup Vorlage.To see the legacy templates from Windows 8.1 and Windows Phone 8.1, see the legacy toast template catalog.

Erste SchritteGetting started

Installieren Sie die Benachrichtigungsbibliothek.Install Notifications library. Wenn Sie C# anstelle von XML verwenden möchten, um Benachrichtigungen zu generieren, installieren Sie das NuGet-Paket mit dem Namen Microsoft.Toolkit.Uwp.Notifications. (Suchen Sie nach „Benachrichtigungen UWP“.)If you'd like to use C# instead of XML to generate notifications, install the NuGet package named Microsoft.Toolkit.Uwp.Notifications (search for "notifications uwp"). Die in diesem Artikel bereitgestellten C#-Beispiele verwenden Version 1.0.0 des NuGet-Pakets.The C# samples provided in this article use version 1.0.0 of the NuGet package.

Installieren Sie den Notifications Visualizer.Install Notifications Visualizer. Diese kostenlose Windows-App hilft Ihnen beim Entwerfen interaktiver Popup Benachrichtigungen, indem Sie während der Bearbeitung eine sofortige visuelle Vorschau Ihres Popups bereitstellen, ähnlich wie der XAML-Editor/die Entwurfs Ansicht von Visual Studio.This free Windows app helps you design interactive toast notifications by providing an instant visual preview of your toast as you edit it, similar to Visual Studio's XAML editor/design view. Weitere Informationen finden Sie unter Benachrichtigungs Schnellansicht, oder Laden Sie die Benachrichtigungs Schnellansicht aus dem Store herunter.See Notifications Visualizer for more information, or download Notifications Visualizer from the Store.

Senden einer Popup BenachrichtigungSending a toast notification

Informationen zum Senden von Benachrichtigungen finden Sie unter Send local Toast.To learn how to send a notification, see Send local toast. In dieser Dokumentation wird nur das Erstellen des Popup Inhalts behandelt.This documentation only covers creating the toast content.

Struktur der PopupbenachrichtigungToast notification structure

Popup Benachrichtigungen sind eine Kombination aus einigen Daten Eigenschaften wie Tag/Gruppe (mit denen die Benachrichtigung identifiziert werden können) und dem Popup Inhalt.Toast notifications are a combination of some data properties like Tag/Group (which let you identify the notification) and the toast content.

Die Kernkomponenten von Popup Inhalten sind...The core components of toast content are...

  • Launch: definiert, welche Argumente an die APP zurückgegeben werden, wenn der Benutzer auf den Popup klickt, sodass Sie tief in den richtigen Inhalt, den der Popup anzeigt, verweisen können.launch: This defines what arguments will be passed back to your app when the user clicks your toast, allowing you to deep link into the correct content that the toast was displaying. Weitere Informationen finden Sie unter Send local Toast.To learn more, see Send local toast.
  • Visual: der visuelle Teil des Popups, einschließlich der generischen Bindung, die Text und Bilder enthält.visual: The visual portion of the toast, including the generic binding that contains text and images.
  • Aktionen: der interaktive Teil des Toast, einschließlich Eingaben und Aktionen.actions: The interactive portion of the toast, including inputs and actions.
  • Audiodatei: steuert die Audiowiedergabe, wenn dem Benutzer der Popup angezeigt wird.audio: Controls the audio played when the toast is shown to the user.

Der Popup Inhalt ist in unformatiertem XML definiert, aber Sie können unsere nuget-Bibliothek verwenden, um ein c#-Objektmodell (oder ein C++-Objekt) zum Erstellen des Popup Inhalts zu erhalten.The toast content is defined in raw XML, but you can use our NuGet library to get a C# (or C++) object model for constructing the toast content. In diesem Artikel wird alles dokumentiert, was innerhalb des Popup Inhalts liegt.This article documents everything that goes within the toast content.

new ToastContentBuilder()
    .AddToastActivationInfo("app-defined-string", ToastActivationType.Foreground)
    .AddText("Some text")
    .AddButton("Archive", ToastActivationType.Background, "archive")
    .AddAudio(new Uri("ms-appx:///Sound.mp3"));

Hier sehen Sie eine visuelle Darstellung des Popup Inhalts:Here is a visual representation of the toast's content:

Struktur der Popupbenachrichtigung

Grafisches ElementVisual

Jeder Toast muss ein visuelles Element angeben, in dem Sie eine generische Popup Bindung bereitstellen müssen, die Text, Bilder und mehr enthalten kann.Each toast must specify a visual, where you must provide a generic toast binding, which can contain text, images, and more. Diese Elemente werden auf verschiedenen Windows-Geräten, einschließlich Desktop, Smartphones, Tablets und Xbox, gerendert.These elements will be rendered on various Windows devices, including desktop, phones, tablets, and Xbox.

Informationen zu allen Attributen, die im visuellen Abschnitt und seinen untergeordneten Elementen unterstützt werden, finden Sie in der Schema Dokumentation.For all attributes supported in the visual section and its child elements, see the schema documentation.

Die Identität ihrer App auf der Popup Benachrichtigung wird über das App-Symbol übermittelt.Your app's identity on the toast notification is conveyed via your app icon. Wenn Sie jedoch das App-Logo außer Kraft setzen, wird Ihr App-Name unter ihren Textzeilen angezeigt.However, if you use the app logo override, we will display your app name beneath your lines of text.

App-Identität für den normalen ToastApp identity for normal toast App-Identität mit applogooverrideApp identity with appLogoOverride
notification without appLogoOverride notification with appLogoOverride

Text ElementeText elements

Jeder Toast muss mindestens ein Textelement enthalten und kann zwei zusätzliche Textelemente enthalten, die alle den Typ " adaptivetext" aufweisen.Each toast must have at least one text element, and can contain two additional text elements, all of type AdaptiveText.

Toast with title and description

Seit dem Windows 10 Anniversary Update können Sie steuern, wie viele Textzeilen angezeigt werden, indem Sie die hintmaxlines -Eigenschaft für den Text verwenden.Since the Windows 10 Anniversary Update, you can control how many lines of text are displayed by using the HintMaxLines property on the text. Der Standardwert (und der Höchstwert) beträgt bis zu zwei Textzeilen für den Titel und bis zu 4 Zeilen (kombiniert) für die beiden zusätzlichen Beschreibungs Elemente (der zweite und dritte adaptivetext).The default (and maximum) is up to 2 lines of text for the title, and up to 4 lines (combined) for the two additional description elements (the second and third AdaptiveText).

new ToastContentBuilder()
    .AddText("Adaptive Tiles Meeting", hintMaxLines: 1)
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

App-Logo ÜberschreibungApp logo override

Standardmäßig wird Ihr App-Logo im Toast angezeigt.By default, your toast will display your app's logo. Allerdings können Sie dieses Logo mit Ihrem eigenen "Image Image capplogo "-Image überschreiben.However, you can override this logo with your own ToastGenericAppLogo image. Wenn es sich beispielsweise um eine Benachrichtigung von einer Person handelt, empfiehlt es sich, das App-Logo mit einem Bild dieser Person zu überschreiben.For example, if this is a notification from a person, we recommend overriding the app logo with a picture of that person.

Toast with app logo override

Sie können die hintcrop -Eigenschaft verwenden, um das Abschneiden des Bilds zu ändern.You can use the HintCrop property to change the cropping of the image. " Circle " führt beispielsweise zu einem Zirkel gebundenen Bild.For example, Circle results in a circle-cropped image. Andernfalls ist das Bild quadratisch.Otherwise, the image is square. Bild Dimensionen sind 48 x 48 Pixel bei einer Skalierung von 100%.Image dimensions are 48x48 pixels at 100% scaling.

new ToastContentBuilder()
    ...
    
    .AddAppLogoOverride(new Uri("https://picsum.photos/48?image=883"), NotificationAppLogoCrop.Circle);

HerabbildHero image

Neu in Anniversary Update: die Toasts können ein Herausgeber Bild anzeigen. Hierbei handelt es sich um ein geenderetes toastgenericheroimage , das hervorgehoben im Popup Banner und im Aktions Center angezeigt wird.New in Anniversary Update: Toasts can display a hero image, which is a featured ToastGenericHeroImage displayed prominently within the toast banner and while inside Action Center. Bild Dimensionen sind 364x 180 Pixel bei der Skalierung von 100%.Image dimensions are 364x180 pixels at 100% scaling.

Toast with hero image
new ToastContentBuilder()
    ...
    
    .AddHeroImage(new Uri("https://picsum.photos/364/180?image=1043"));

Inline BildInline image

Sie können ein Inline Bild mit voller Breite bereitstellen, das angezeigt wird, wenn Sie den Toast erweitern.You can provide a full-width inline-image that appears when you expand the toast.

Toast with additional image
new ToastContentBuilder()
    ...
    
    .AddInlineImage(new Uri("https://picsum.photos/360/202?image=1043"));

Einschränkungen bei der Image GrößeImage size restrictions

Die Images, die Sie in ihrer Popup Benachrichtigung verwenden, können aus stammen...The images you use in your toast notification can be sourced from...

  • http://http://
  • ms-appx:///ms-appx:///
  • ms-appdata:///ms-appdata:///

Für http-und HTTPS-Remoteweb Images gibt es Beschränkungen hinsichtlich der Dateigröße jedes einzelnen Bilds.For http and https remote web images, there are limits on the file size of each individual image. Im Fall Creators Update (16299) haben wir den Grenzwert bei normalen Verbindungen um 3 MB und bei getakteten Verbindungen um 1 MB verlängert.In the Fall Creators Update (16299), we increased the limit to be 3 MB on normal connections and 1 MB on metered connections. Zuvor waren Bilder immer auf 200 KB beschränkt.Before that, images were always limited to 200 KB.

Normale VerbindungNormal connection Getaktete VerbindungMetered connection Vor Fall Creators UpdateBefore Fall Creators Update
3 MB3 MB 1 MB1 MB 200 KB200 KB

Wenn ein Bild die Dateigröße überschreitet oder nicht heruntergeladen werden kann oder ein Timeout auftritt, wird das Image gelöscht, und der Rest der Benachrichtigung wird angezeigt.If an image exceeds the file size, or fails to download, or times out, the image will be dropped and the rest of the notification will be displayed.

Zuweisungs TextAttribution text

Neu in Anniversary Update: Wenn Sie auf die Quelle ihres Inhalts verweisen müssen, können Sie den Zuweisungs Text verwenden.New in Anniversary Update: If you need to reference the source of your content, you can use attribution text. Dieser Text wird immer am Ende der Benachrichtigung zusammen mit der Identität ihrer APP oder dem Zeitstempel der Benachrichtigung angezeigt.This text is always displayed at the bottom of your notification, along with your app's identity or the notification's timestamp.

In älteren Versionen von Windows, die keinen Zuweisungs Text unterstützen, wird der Text einfach als anderes Textelement angezeigt (vorausgesetzt, Sie haben nicht bereits die maximal drei Textelemente).On older versions of Windows that don't support attribution text, the text will simply be displayed as another text element (assuming you don't already have the maximum of three text elements).

Toast with attribution text
new ToastContentBuilder()
    ...
    
    .AddAttributionText("Via SMS");

Benutzerdefinierter ZeitstempelCustom timestamp

Neues in Creators Update: Sie können nun den vom System bereitgestellten Zeitstempel mit Ihrem eigenen Zeitstempel überschreiben, der genau angibt, wann die Nachricht/Informationen/der Inhalt generiert wurde.New in Creators Update: You can now override the system-provided timestamp with your own timestamp that accurately represents when the message/information/content was generated. Dieser Zeitstempel ist innerhalb des Aktions Centers sichtbar.This timestamp is visible within Action Center.

Toast with custom timestamp

Weitere Informationen zum Verwenden eines benutzerdefinierten Zeitstempels finden Sie unter benutzerdefinierte Zeitstempel in den-Umfassungen.To learn more about using a custom timestamp, please see custom timestamps on toasts.

new ToastContentBuilder()
    ...
    
    .AddCustomTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

StatusleisteProgress bar

Neues in Creators Update: Sie können eine Statusanzeige für ihre Popup Benachrichtigung bereitstellen, um den Benutzer über den Fortschritt von Vorgängen, z. b. Downloads, zu informieren.New in Creators Update: You can provide a progress bar on your toast notification to keep the user informed of the progress of operations such as downloads.

Toast with progress bar

Weitere Informationen zum Verwenden einer Statusanzeige finden Sie unter Popup- StatusAnzeige.To learn more about using a progress bar, please see Toast progress bar.

HeaderHeaders

Neues in Creators Update: Sie können Benachrichtigungen im Aktions Center unter Header gruppieren.New in Creators Update: You can group notifications under headers within Action Center. Beispielsweise können Sie Nachrichten aus einem Gruppenchat unter einem Header gruppieren oder Benachrichtigungen eines allgemeinen Designs unter einem Header gruppieren.For example, you can group messages from a group chat under a header, or group notifications of a common theme under a header, or more.

Toasts with header

Weitere Informationen zum Verwenden von Headern finden Sie unter Popup Header.To learn more about using headers, please see Toast headers.

Adaptive InhalteAdaptive content

Neu in Anniversary Update: Zusätzlich zu den oben angegebenen Inhalten können auch zusätzliche Adaptive Inhalte angezeigt werden, die sichtbar sind, wenn der Toast erweitert wird.New in Anniversary Update: In addition to the content specified above, you can also display additional adaptive content that is visible when the toast is expanded.

Dieser zusätzliche Inhalt wird mithilfe von adaptiver angegeben. Weitere Informationen hierzu finden Sie in der Dokumentation zu adaptiven Kacheln.This additional content is specified using Adaptive, which you can learn more about by reading the Adaptive Tiles documentation.

Beachten Sie, dass alle adaptiven Inhalte in einer adaptivegroupenthalten sein müssen.Note that any adaptive content must be contained within an AdaptiveGroup. Andernfalls wird Sie nicht mit Adaptive gerendert.Otherwise it will not be rendered using adaptive.

Spalten und TextelementeColumns and text elements

Im folgenden finden Sie ein Beispiel, in dem Spalten und einige erweiterte Adaptive Textelemente verwendet werden.Here's an example where columns and some advanced adaptive text elements are used. Da sich die Textelemente innerhalb einer adaptivegroupbefinden, unterstützen Sie alle umfangreichen adaptiven Formatierungs Eigenschaften.Since the text elements are within an AdaptiveGroup, they support all the rich adaptive styling properties.

Toast with additional text
new ToastContentBuilder()
    ...
    
    .AddVisualChild(new AdaptiveGroup()
    {
        Children =
        {
            new AdaptiveSubgroup()
            {
                Children =
                {
                    new AdaptiveText()
                    {
                        Text = "52 attendees",
                        HintStyle = AdaptiveTextStyle.Base
                    },
                    new AdaptiveText()
                    {
                        Text = "23 minute drive",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle
                    }
                }
            },
            new AdaptiveSubgroup()
            {
                Children =
                {
                    new AdaptiveText()
                    {
                        Text = "1 Microsoft Way",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle,
                        HintAlign = AdaptiveTextAlign.Right
                    },
                    new AdaptiveText()
                    {
                        Text = "Bellevue, WA 98008",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle,
                        HintAlign = AdaptiveTextAlign.Right
                    }
                }
            }
        }
    });

SchaltflächenButtons

Schaltflächen machen Ihren Toast interaktiv, sodass der Benutzer schnelle Aktionen für ihre Popup Benachrichtigung durchführen kann, ohne den aktuellen Workflow zu unterbrechen.Buttons make your toast interactive, letting the user take quick actions on your toast notification without interrupting their current workflow. Beispielsweise können Benutzer direkt von einem Toast aus auf eine Nachricht antworten oder eine e-Mail löschen, ohne die e-Mail-APP zu öffnen.For example, users can reply to a message directly from within a toast, or delete an email without even opening the email app. Schaltflächen werden im erweiterten Teil ihrer Benachrichtigung angezeigt.Buttons appear in the expanded portion of your notification.

Weitere Informationen zum End-to-End-Implementieren von Schaltflächen finden Sie unter Send local Toast.To learn more about implementing buttons end-to-end, see Send local toast.

Schaltflächen können die folgenden unterschiedlichen Aktionen ausführen...Buttons can perform the following different actions...

  • Aktivieren der APP im Vordergrund mit einem Argument, das verwendet werden kann, um zu einer bestimmten Seite/einem bestimmten Kontext zu navigieren.Activating the app in the foreground, with an argument that can be used to navigate to a specific page/context.
  • Aktivieren der Hintergrundaufgabe der APP für eine schnelle Antwort oder ein ähnliches Szenario.Activating the app's background task, for a quick-reply or similar scenario.
  • Aktivieren einer anderen App per Protokollstart.Activating another app via protocol launch.
  • Ausführen einer System Aktion, z. b. das Zurückstellen oder verwerfen der Benachrichtigung.Performing a system action, such as snoozing or dismissing the notification.

Hinweis

Sie können nur bis zu 5 Schaltflächen (einschließlich Kontextmenü Elemente, die später besprochen werden) enthalten.You can only have up to 5 buttons (including context menu items which we discuss later).

notification with actions, example 1
new ToastContentBuilder()
    ...
    
    .AddButton("See more details", ToastActivationType.Foreground, "action=viewdetails&contentId=351")
    .AddButton("Remind me later", ToastActivationType.Background, "action=remindlater&contentId=351");

Schaltflächen mit SymbolenButtons with icons

Sie können den Schaltflächen Symbole hinzufügen.You can add icons to your buttons. Diese Symbole sind weiß transparente 16x16-Pixelbilder bei der Skalierung von 100% und sollten keine Auffüll Zeichen im Bild selbst enthalten.These icons are white transparent 16x16 pixel images at 100% scaling, and should have no padding included in the image itself. Wenn Sie Symbole für eine Popup Benachrichtigung bereitstellen möchten, müssen Sie Symbole für alle Schaltflächen in der Benachrichtigung angeben, da der Stil der Schaltflächen in Symbol Schaltflächen transformiert wird.If you choose to provide icons on a toast notification, you must provide icons for ALL of your buttons in the notification, as it transforms the style of your buttons into icon buttons.

Hinweis

Achten Sie bei der Barrierefreiheit darauf, dass Sie eine weiße Kontrast Version des Symbols (ein schwarzes Symbol für weiße Hintergründe) einschließen, damit das Symbol angezeigt wird, wenn der Benutzer hoher Kontrast den weißen Modus wechselt.For accessibility, be sure to include a contrast-white version of the icon (a black icon for white backgrounds), so that when the user turns on High Contrast White mode, your icon is visible. Weitere Informationen finden Sie auf der Seite Toast Barrierefreiheits.Learn more on the toast accessiblity page.

Toast that has buttons with icons
new ToastContentBuilder()
    ...
    
    .AddButton(
        "Dismiss",
        ToastActivationType.Foreground,
        "dismiss", new Uri("Assets/NotificationButtonIcons/Dismiss.png", UriKind.Relative));

Schaltflächen mit ausstehender Update AktivierungButtons with pending update activation

Neu bei Fall Creators Update: auf den Hintergrund Aktivierungs Schaltflächen können Sie ein nach dem Aktivierungs Verhalten von " tabdingupdate " verwenden, um mehrstufige Interaktionen in ihren Popup Benachrichtigungen zu erstellen.New in Fall Creators Update: On background activation buttons, you can use an after activation behavior of PendingUpdate to create multi-step interactions in your toast notifications. Wenn der Benutzer auf die Schaltfläche klickt, wird die Hintergrundaufgabe aktiviert, und der Toast wird in den Zustand "ausstehende Aktualisierung" versetzt, wo er auf dem Bildschirm bleibt, bis die Hintergrundaufgabe den Toast durch einen neuen Toast ersetzt.When the user clicks your button, your background task is activated, and the toast gets placed in a "pending update" state, where it stays on screen till your background task replaces the toast with a new toast.

Informationen dazu, wie Sie diese Implementierung implementieren, finden Sie unter Popup Pending Update.To learn how to implement this, see Toast pending update.

Toast mit ausstehenden Updates

Aktionen im KontextmenüContext menu actions

Neu in Anniversary Update: Sie können dem vorhandenen Kontextmenü zusätzliche Kontextmenü Aktionen hinzufügen, die angezeigt werden, wenn der Benutzer im Aktions Center mit der rechten Maustaste auf den Toast klickt.New in Anniversary Update: You can add additional context menu actions to the existing context menu that appears when the user right clicks your toast from within Action Center. Beachten Sie, dass dieses Menü nur angezeigt wird, wenn Sie mit der rechten Maustaste im Aktions CenterNote that this menu only appears when right clicked from Action Center. Wird nicht angezeigt, wenn Sie mit der rechten Maustaste auf ein Popup-Popup Banner klicken.It does not appear when right clicking a toast popup banner.

Hinweis

Auf älteren Geräten werden diese zusätzlichen Kontextmenü Aktionen einfach als normale Schaltflächen auf dem Toast angezeigt.On older devices, these additional context menu actions will simply appear as normal buttons on your toast.

Die zusätzlichen Kontextmenü Aktionen, die Sie hinzufügen (z. b. "Änderungs Speicherort"), werden oberhalb der beiden Standardsystem Einträge angezeigt.The additional context menu actions you add (such as "Change location") appear above the two default system entries.

Toast with context menu

Die Generator-Syntax unterstützt keine Kontextmenü Aktionen. Daher empfiehlt es sich, die initialisierersyntax zu verwenden.The builder syntax doesn't support context menu actions, so we recommend using initializer syntax.

ToastContent content = new ToastContent()
{
    ...
 
    Actions = new ToastActionsCustom()
    {
        ContextMenuItems =
        {
            new ToastContextMenuItem("Change location", "action=changeLocation")
        }
    }
};

Hinweis

Zusätzliche Kontextmenü Elemente tragen zum Gesamtlimit von 5 Schaltflächen in einem Toast bei.Additional context menu items contribute to the total limit of 5 buttons on a toast.

Die Aktivierung zusätzlicher Kontextmenü Elemente wird mit Popup Schaltflächen identisch behandelt.Activation of additional context menu items is handled identical to toast buttons.

EingabenInputs

Eingaben werden innerhalb des Aktionsbereichs des Popup Bereichs des Popups angegeben. Dies bedeutet, dass Sie nur sichtbar sind, wenn der Toast erweitert wird.Inputs are specified within the Actions region of the toast region of the toast, meaning they are only visible when the toast is expanded.

Textfeld für die schnelle AntwortQuick reply text box

Wenn Sie ein Textfeld für die schnelle Antwort (z. b. in einer Messaging-APP) aktivieren möchten, fügen Sie eine Texteingabe und eine Schaltfläche hinzu, und verweisen Sie auf die ID des Texteingabe Felds, sodass die Schaltfläche neben dem Eingabefeld angezeigt wird.To enable a quick reply text box (for example, in a messaging app) add a text input and a button, and reference the ID of the text input field so that the button is displayed next to to the input field. Das Symbol für die Schaltfläche muss ein 32 x 32 Pixel-Bild ohne Auffüll Zeichen, weiße Pixel auf transparent und 100% Skalierung sein.The icon for the button should be a 32x32 pixel image with no padding, white pixels set to transparent, and 100% scale.

notification with text input and actions
new ToastContentBuilder()
    ...
    
    .AddInputTextBox("tbReply", "Type a reply")

    .AddButton(
        textBoxId: "tbReply", // To place button next to text box, reference text box's id
        content: "Reply",
        activationType: ToastActivationType.Background,
        arguments: "action=reply&convId=9318",
        imageUri: new Uri("Assets/Reply.png", UriKind.Relative));

Eingaben mit Schaltflächen LeisteInputs with buttons bar

Sie können auch über eine (oder viele) Eingabe mit normalen Schaltflächen verfügen, die unter den Eingaben angezeigt werden.You also can have one (or many) inputs with normal buttons displayed below the inputs.

notification with text and input actions
new ToastContentBuilder()
    ...
    
    .AddInputTextBox("tbReply", "Type a reply")

    .AddButton("Reply", ToastActivationType.Background, "action=reply&threadId=9218")
    .AddButton("Video call", ToastActivationType.Foreground, "action=videocall&threadId=9218");

Auswahl EingabeSelection input

Zusätzlich zu Textfeldern können Sie auch ein Auswahlmenü verwenden.In addition to text boxes, you can also use a selection menu.

notification with selection input and actions
new ToastContentBuilder()
    ...
    
    .AddToastInput(new ToastSelectionBox("time")
    {
        DefaultSelectionBoxItemId = "lunch",
        Items =
        {
            new ToastSelectionBoxItem("breakfast", "Breakfast"),
            new ToastSelectionBoxItem("lunch", "Lunch"),
            new ToastSelectionBoxItem("dinner", "Dinner")
        }
    })

    .AddButton(...)
    .AddButton(...);

Zurückstellen/verwerfenSnooze/dismiss

Mit einem Auswahlmenü und zwei Schaltflächen können wir eine Erinnerungs Benachrichtigung erstellen, die das System zum Zurücksetzen und Verwerfen von Aktionen verwendet.Using a selection menu and two buttons, we can create a reminder notification that utilizes the system snooze and dismiss actions. Stellen Sie sicher, dass das Szenario als Erinnerung festgelegt wird, damit die Benachrichtigung sich wie eine Erinnerung verhält.Make sure to set the scenario to Reminder for the notification to behave like a reminder.

reminder notification

Wir verknüpfen die Schaltfläche "Zurücksetzen" mit der Auswahlmenü Eingabe mithilfe der selectionboxid -Eigenschaft auf der Popup Schaltfläche.We link the Snooze button to the selection menu input using the SelectionBoxId property on the toast button.

new ToastContentBuilder()
    .SetToastScenario(ToastScenario.Reminder)
    
    ...
    
    .AddToastInput(new ToastSelectionBox("snoozeTime")
    {
        DefaultSelectionBoxItemId = "15",
        Items =
        {
            new ToastSelectionBoxItem("5", "5 minutes"),
            new ToastSelectionBoxItem("15", "15 minutes"),
            new ToastSelectionBoxItem("60", "1 hour"),
            new ToastSelectionBoxItem("240", "4 hours"),
            new ToastSelectionBoxItem("1440", "1 day")
        }
    })

    .AddButton(new ToastButtonSnooze() { SelectionBoxId = "snoozeTime" })
    .AddButton(new ToastButtonDismiss());

So verwenden Sie die System Aktion zum Zurücksetzen und Verwerfen von Aktionen:To use the system snooze and dismiss actions:

  • Geben Sie ein " onastbuttonsnooze " oder " onastbuttonverwerfen " anSpecify a ToastButtonSnooze or ToastButtonDismiss
  • Geben Sie optional eine benutzerdefinierte Inhalts Zeichenfolge an:Optionally specify a custom content string:
    • Wenn Sie keine Zeichenfolge angeben, werden automatisch lokalisierte Zeichen folgen für "zurückstellen" und "verwerfen" verwendet.If you don't provide a string, we'll automatically use localized strings for "Snooze" and "Dismiss".
  • Geben Sie optional selectionboxidan:Optionally specify the SelectionBoxId:
    • Wenn Sie nicht möchten, dass der Benutzer ein Intervall für das erneute Erinnern auswählen kann, sondern das erneute Erinnern an die Benachrichtigung nur einmal in einem vom System definierten (in allen Betriebssystemen einheitlichen) Zeitintervall erfolgt, legen Sie keinen Wert für <input> fest.If you don't want the user to select a snooze interval and instead just want your notification to snooze only once for a system-defined time interval (that is consistent across the OS), then don't construct any <input> at all.
    • Wenn Sie mögliche Intervalle für das erneute Erinnern bereitstellen möchten:If you want to provide snooze interval selections:
      • Angeben von selectionboxid in der Aktion zum ZurücksetzenSpecify SelectionBoxId in the snooze action
      • Vergleichen Sie die ID der Eingabe mit der selectionboxid der Aktion zum Zurücksetzen.Match the id of the input with the SelectionBoxId of the snooze action
      • Legen Sie den Wert von " alastselectionboxitem" als nonnegativeinzelteger fest, der das Intervall für die Wartezeit in Minuten darstellt.Specify ToastSelectionBoxItem's value to be a nonNegativeInteger which represents snooze interval in minutes.

AudioAudio

Benutzerdefiniertes Audiogerät wurde von mobilen Geräten immer unterstützt und wird in Desktop Version 1511 (Build 10586) oder höher unterstützt.Custom audio has always been supported by Mobile, and is supported in Desktop Version 1511 (build 10586) or newer. Auf benutzerdefiniertes Audiodaten kann über die folgenden Pfade verwiesen werden:Custom audio can be referenced via the following paths:

  • ms-appx:///ms-appx:///
  • ms-appdata:///ms-appdata:///

Alternativ können Sie aus der Liste der MS-winsoundebug-Ereignisse auswählen, die immer auf beiden Plattformen unterstützt werden.Alternatively, you can pick from the list of ms-winsoundevents, which have always been supported on both platforms.

new ToastContentBuilder()
    ...
    
    .AddAudio(new Uri("ms-appx:///Assets/NewMessage.mp3"));

Informationen zu Audiobenachrichtigungen in Popup Benachrichtigungen finden Sie auf der Seite Audioschema .See the audio schema page for information on audio in toast notifications. Informationen zum Senden eines Popups mithilfe von benutzerdefiniertem Audioinhalt finden Sie unter benutzerdefinierte Audioinformationen in Popups.To learn how to send a toast using custom audio, see custom audio on toasts.

Alarme, Erinnerungen und eingehende AnrufeAlarms, reminders, and incoming calls

Um Alarme, Erinnerungen und eingehende Benachrichtigungen zu erstellen, verwenden Sie einfach eine normale Popup Benachrichtigung mit einem ihm zugewiesenen szenariowert.To create alarms, reminders, and incoming call notifications, you simply use a normal toast notification with a scenario value assigned to it. Das Szenario ist eine Reihe von Verhaltensweisen, mit denen eine konsistente und einheitliche Benutzerfunktion erstellt wird.The scenario adusts a few behaviors to create a consistent and unified user experience.

Wichtig

Bei der Verwendung der Erinnerung oder des Alarms müssen Sie mindestens eine Schaltfläche in der Popup Benachrichtigung angeben.When using Reminder or Alarm, you must provide at least one button on your toast notification. Andernfalls wird der Toast als normaler Toast behandelt.Otherwise, the toast will be treated as a normal toast.

  • Erinnerung: die Benachrichtigung bleibt auf dem Bildschirm, bis der Benutzer Sie schließt oder Maßnahmen ergreift.Reminder: The notification will stay on screen until the user dismisses it or takes action. Unter Windows Mobile wird der Toast auch vorab erweitert angezeigt.On Windows Mobile, the toast will also show pre-expanded. Ein Erinnerungs Sound wird wiedergegeben.A reminder sound will be played.
  • Alarm: Zusätzlich zu den Erinnerungs Verhaltensweisen werden Alarme zusätzlich zu einem standardmäßigen Alarm Soundschleifen.Alarm: In addition to the reminder behaviors, alarms will additionally loop audio with a default alarm sound.
  • IncomingCall: eingehende Benachrichtigungen werden auf Windows Mobile-Geräten als Vollbild angezeigt.IncomingCall: Incoming call notifications are displayed full screen on Windows Mobile devices. Andernfalls haben Sie das gleiche Verhalten wie Alarme, außer Sie verwenden Rington-Audiodaten und ihre Schaltflächen werden anders formatiert.Otherwise, they have the same behaviors as alarms except they use ringtone audio and their buttons are styled differently.
new ToastContentBuilder()
    .SetToastScenario(ToastScenario.Reminder)
    ...

Lokalisierung und BarrierefreiheitLocalization and accessibility

Mit ihren Kacheln und-aufbildern können Zeichen folgen und Bilder geladen werden, die für die Anzeige Sprache, den Anzeige Skalierungsfaktor, den hohen Kontrast und andere Lauf Zeit KontexteYour tiles and toasts can load strings and images tailored for display language, display scale factor, high contrast, and other runtime contexts. Weitere Informationen finden Sie unter Unterstützung für Kachel-und Popup Benachrichtigungen für Sprache, Skalierung und hohen Kontrast.For more info, see Tile and toast notification support for language, scale, and high contrast.

Aktivierungs AktivierungHandling activation

Informationen zum Behandeln von Popup Aktivierungen (der Benutzer, der auf den Toast oder die Schaltflächen des Popups klickt) finden Sie unter Send local Toast.To learn how to handle toast activations (the user clicking your toast or buttons on the toast), see Send local toast.