AppNotificationButton Klasse

Definition

Namespace:

Microsoft.Windows.AppNotifications.Builder

Stellt eine Schaltfläche dar, die in einer App-Benachrichtigung angezeigt wird.

public ref class AppNotificationButton sealed

/// [Windows.Foundation.Metadata.Activatable(Microsoft.Windows.AppNotifications.Builder.IAppNotificationButtonFactory, 65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppNotificationButton final

[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.Windows.AppNotifications.Builder.IAppNotificationButtonFactory), 65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppNotificationButton

function AppNotificationButton(content)

Public NotInheritable Class AppNotificationButton

Vererbung

Object Platform::Object IInspectable AppNotificationButton

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Das folgende Beispiel veranschaulicht das Hinzufügen einer Schaltfläche zur XML-Nutzlast für eine App-Benachrichtigung.

var notification = new AppNotificationBuilder()
    .AddText("Send a message.")
    .AddTextBox("textBox")
    .AddButton(new AppNotificationButton("Send")
        .AddArgument("action", "sendMessage"))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Send a message.</text>
        </binding>
    </visual>
    <actions>
        <input id='textBox' type='text'/><action content='Send' arguments='action=sendMessage'/>
    </actions>
</toast>

Hinweise

Fügen Sie der XML-Nutzlast für eine App-Benachrichtigung eine Schaltfläche hinzu, indem Sie AppNotificationBuilder.AddButton aufrufen. Einer einzelnen App-Benachrichtigung können bis zu 5 Schaltflächen hinzugefügt werden.

Eine Anleitung zur Verwendung der AppNotificationBuilder-APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalte.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter Inhaltsschema für App-Benachrichtigungen.

Konstruktoren

AppNotificationButton()	Initialisiert eine neue instance der AppNotificationButton-Klasse.
AppNotificationButton(String)	Initialisiert eine neue instance der AppNotificationButton-Klasse mit dem angegebenen Schaltflächentext.

Eigenschaften

Arguments	Ruft die Argumente ab, die appNotificationButton zugeordnet sind, oder legt sie fest.
ButtonStyle	Ruft den Stil einer Schaltfläche ab oder legt diese fest.
Content	Ruft den Schaltflächentext für ein AppNotificationButton-Objekt ab oder legt den Text fest.
ContextMenuPlacement	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Schaltfläche im Kontextmenü der App-Benachrichtigung angezeigt wird.
Icon	Ruft das Symbol für ein AppNotificationButton-Objekt ab oder legt es fest.
InputId	Ruft die Eingabe-ID für ein AppNotificationButton-Objekt ab oder legt sie fest.
InvokeUri	Ruft den URI ab, der gestartet wird, wenn auf die App-Benachrichtigungsschaltfläche geklickt wird, oder legt diesen fest.
TargetAppId	Ruft den Paketfamiliennamen (Package Family Name, PFN) für die App ab, die gestartet werden soll, wenn auf die App-Benachrichtigungsschaltfläche geklickt wird, oder legt diesen fest.
ToolTip	Ruft den QuickInfotext für die App-Benachrichtigungsschaltfläche ab oder legt den Text fest.

Methoden

AddArgument(String, String)	Fügt der XML-Nutzlast für eine App-Benachrichtigungsschaltfläche ein Argument hinzu, das aus einem Schlüssel-Wert-Paar besteht.
IsButtonStyleSupported()	Gibt einen Wert zurück, der angibt, ob Schaltflächenstile für App-Benachrichtigungsschaltflächen auf dem aktuellen Gerät unterstützt werden.
IsToolTipSupported()	Gibt einen Wert zurück, der angibt, ob QuickInfos für App-Benachrichtigungsschaltflächen auf dem aktuellen Gerät unterstützt werden.
SetButtonStyle(AppNotificationButtonStyle)	Legt den Schaltflächenstil für die App-Benachrichtigungsschaltfläche fest.
SetContextMenuPlacement()	Fordert an, dass die App-Benachrichtigungsschaltfläche im Kontextmenü der Benachrichtigung platziert wird.
SetIcon(Uri)	Legt das Symbol für ein AppNotificationButton-Objekt fest.
SetInputId(String)	Legt die Eingabe-ID für ein AppNotificationButton-Objekt fest.
SetInvokeUri(Uri)	Legt den URI fest, der gestartet wird, wenn auf die App-Benachrichtigungsschaltfläche geklickt wird.
SetInvokeUri(Uri, String)	Legt den URI fest, der gestartet wird, wenn auf die App-Benachrichtigungsschaltfläche geklickt wird, mit einem bereitgestellten Paketfamiliennamen (PFN) zur Mehrdeutigkeit.
SetToolTip(String)	Legt den QuickInfotext für die App-Benachrichtigungsschaltfläche fest.