AppNotificationButton Klasse
Definition
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.
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
- Attribute
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. |