AppNotificationButton Klasse

Definition

Namespace:
Microsoft.Windows.AppNotifications.Builder
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 für eine App-Benachrichtigung eine Schaltfläche hinzu, indem Sie AppNotificationBuilder.AddButton aufrufen). 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

Name Beschreibung
AppNotificationButton()

Initialisiert eine neue Instanz der AppNotificationButton-Klasse .
AppNotificationButton(String)

Initialisiert eine neue Instanz der AppNotificationButton-Klasse mit dem angegebenen Schaltflächentext.

Eigenschaften

Name Beschreibung
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-Objekt.
ContextMenuPlacement

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Schaltfläche im App-Benachrichtigungskontextmenü 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 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

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

Name Beschreibung
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-Objekt fest.
SetInputId(String)

Legt die Eingabe-ID für ein AppNotificationButton-Objekt 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.
SetSettingStyle(AppNotificationButtonSettingStyle)

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

Legt den QuickInfo-Text für die App-Benachrichtigungsschaltfläche fest.

Gilt für: