AppNotificationButton Klasse

Referenz

Definition

Namespace:: Microsoft.Windows.AppNotifications.Builder

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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 einer App-Benachrichtigung eine Schaltfläche hinzu, indem Sie AppNotificationBuilder.AddButtonaufrufen. Bis zu 5 Schaltflächen können einer einzelnen App-Benachrichtigung hinzugefügt werden.

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

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

Konstruktoren

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

Eigenschaften

Arguments	Dient zum Abrufen oder Festlegen der Argumente, die dem AppNotificationButton-zugeordnet sind.
ButtonStyle	Dient zum Abrufen oder Festlegen des Stils einer Schaltfläche.
Content	Dient zum Abrufen oder Festlegen des Schaltflächentexts für ein AppNotificationButton-.
ContextMenuPlacement	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Schaltfläche im App-Benachrichtigungskontextmenü angezeigt wird.
Icon	Dient zum Abrufen oder Festlegen des Symbols für ein AppNotificationButton-.
InputId	Dient zum Abrufen oder Festlegen der Eingabe-ID für ein AppNotificationButton-.
InvokeUri	Ruft den URI ab, der gestartet wird, wenn auf die App-Benachrichtigungsschaltfläche geklickt wird, oder legt diesen fest.
TargetAppId	Dient zum Abrufen oder Festlegen des Paketfamiliennamens (Package Family Name, PFN), damit die App gestartet wird, wenn auf die App-Benachrichtigungsschaltfläche geklickt wird.
ToolTip	Dient zum Abrufen oder Festlegen des QuickInfo-Texts für die App-Benachrichtigungsschaltfläche.

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ächenformate 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-fest.
SetInputId(String)	Legt die Eingabe-ID für ein AppNotificationButton-fest.
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.
SetInvokeUri(Uri)	Legt den URI fest, der gestartet wird, wenn auf die App-Benachrichtigungsschaltfläche geklickt wird.
SetToolTip(String)	Legt den QuickInfo-Text für die App-Benachrichtigungsschaltfläche fest.

Gilt für:

Freigeben über