Freigeben über


action (Popup-XML-Schema)

Gibt eine Schaltfläche an, die in einem Popup angezeigt wird.

Elementhierarchie

<Toast>
<Aktionen>
<Eingabe>

Syntax

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    afterActivationBehavior? = "default" | "pendingUpdate"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

Schlüssel

? optional (null oder 1)

Attribute und Elemente

Attribute

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
Inhalt Der auf der Schaltfläche angezeigte Inhalt. Zeichenfolge Ja Keine
Argumente App-definierte Zeichenfolge von Argumenten, die die App später erhält, wenn der Benutzer auf diese Schaltfläche klickt. Zeichenfolge Ja Keine
Typ Eine Argumentzeichenfolge, die an die zugeordnete App übergeben werden kann, um Einzelheiten zur Aktion anzugeben, die als Reaktion auf die Benutzeraktion ausgeführt werden soll. Zeichenfolge Ja Keine
activationType Bestimmt den Aktivierungstyp, der verwendet wird, wenn der Benutzer mit einer bestimmten Aktion interagiert.
  • "vordergrund": Standardwert. Ihre Vordergrund-App wird gestartet.
  • "Hintergrund": Ihre entsprechende Hintergrundaufgabe wird ausgelöst, und Sie können Code im Hintergrund ausführen, ohne den Benutzer zu unterbrechen.
  • "Protokoll": Starten Sie eine andere App mithilfe der Protokollaktivierung.
Zeichenfolge No "Vordergrund"
afterActivationBehavior Gibt das Verhalten an, das das Popup verwenden soll, wenn der Benutzer eine Aktion für das Popup ausführt.
  • "default" – Standardwert. Das Popup wird geschlossen, wenn der Benutzer eine Aktion für das Popup ausführt.
  • "pendingUpdate": Nachdem der Benutzer auf eine Schaltfläche in Ihrem Popup geklickt hat, bleibt die Benachrichtigung im visuellen Zustand "Pending Update" vorhanden. Sie sollten Ihr Popup sofort aus einer Hintergrundaufgabe aktualisieren, damit der Benutzer diesen visuellen Status "Ausstehendes Update" nicht zu lange sieht.
Zeichenfolge No "default"
Platzierung Wenn sie auf "contextMenu" festgelegt ist, wird die Aktion zu einer Kontextmenüaktion, die dem Kontextmenü der Popupbenachrichtigung hinzugefügt wird, und nicht zu einer herkömmlichen Popupschaltfläche. Zeichenfolge Nein Keine
imageUri Der URI der Bildquelle für ein Popupschaltflächensymbol. Bei diesen Symbolen handelt es sich um weiße transparente Bilder mit 16 x 16 Pixeln bei einer Skalierung von 100 % und sollten keine Auffüllung im Bild selbst enthalten sein. Wenn Sie Symbole für eine Popupbenachrichtigung bereitstellen möchten, müssen Sie Symbole für ALLE Schaltflächen in der Benachrichtigung angeben, da sie den Stil der Schaltflächen in Symbolschaltflächen transformiert. Verwenden Sie einen der folgenden Protokollhandler:
  • http:// oder https://: Ein webbasiertes Bild.
  • ms-appx:/// – Ein Bild, das im App-Paket enthalten ist.
  • ms-appdata:///local/ – Ein Im lokalen Speicher gespeichertes Bild.
  • file:///: Ein lokales Image. (Wird nur für Desktop-Apps unterstützt. Dieses Protokoll kann nicht von UWP-Apps verwendet werden.)
Zeichenfolge Nein Keine
hint-inputId Legen Sie auf die ID einer Eingabe fest, um die Schaltfläche neben der Eingabe zu positionieren. Zeichenfolge Nein Keine
hint-buttonStyle Das Schaltflächenformat. useButtonStyle muss im toast-Element auf true festgelegt werden.
  • "Erfolg" – Die Schaltfläche ist grün
  • "Kritisch": Die Schaltfläche ist rot.
Beachten Sie, dass bei diesen Werten die Groß-/Kleinschreibung beachtet wird.
Zeichenfolge Nein Keine
hint-quickTip Die QuickInfo für eine Schaltfläche, wenn die Schaltfläche eine leere Inhaltszeichenfolge enthält. Zeichenfolge Nein Keine

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
actions Containerelement zum Deklarieren von bis zu fünf Eingaben und bis zu fünf Schaltflächenaktionen für die Popupbenachrichtigung.

Weitere Informationen