Freigeben über


Popup (Xml-Popupschema)

Basis-Popupelement, das mindestens ein einzelnes visuelles Element enthält.

Elementhierarchie

<Toast>

Syntax

<toast launch?   = string
      duration? = "long" | "short" 
      displayTimeStamp? = string
      scenario? = "reminder" | "alarm" | "incomingCall" | "urgent" 
      useButtonStyle? = boolean>

  <!-- Child elements -->
  visual,
  audio?,
  commands?
  actions?
  header?
</toast>

Schlüssel

? optional (null oder 1)

Attribute und Elemente

Attribute

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
duration

Die Zeitspanne, die das Popup anzeigen soll.

Dieses Attribut kann einen der folgenden Werte annehmen:

  • long
  • short
Nein Keine
Starten

Eine Zeichenfolge wird an die Anwendung übergeben, wenn sie durch das Popup aktiviert wird. Das Format und der Inhalt dieser Zeichenfolge werden von der App für eigene Zwecke definiert. Wenn der Benutzer zum Starten der zugeordneten App auf das Popup tippt oder klickt, stellt die Startzeichenfolge der App den Kontext bereit, um dem Benutzer eine Ansicht passend zum Popupinhalt zu ermöglichen, anstatt sie in der Standardgröße starten.

Zeichenfolge Nein Keine
displayTimestamp

Eingeführt in Creators Update: Überschreibt den Standardzeitstempel mit einem benutzerdefinierten Zeitstempel, der angibt, wann Ihr Benachrichtigungsinhalt tatsächlich übermittelt wurde, und nicht den Zeitpunkt, zu dem die Benachrichtigung von der Windows-Plattform empfangen wurde. Dieser Wert muss eine Zeichenfolge sein, die mit dem ISO 8601-Standard formatiert ist.

Zeichenfolge Nein Keine
scenario

Das Szenario, für das Ihr Popup verwendet wird, z. B. ein Alarm oder eine Erinnerung.

  • "Erinnerung" – Eine Erinnerungsbenachrichtigung. Dies wird vorab erweitert angezeigt und bleibt auf dem Bildschirm des Benutzers, bis er geschlossen wird. Beachten Sie, dass dies im Hintergrund ignoriert wird, es sei denn, es gibt eine Popupschaltfläche, die im Hintergrund aktiviert wird.
  • "Alarm" – Eine Alarmbenachrichtigung. Dies wird vorab erweitert angezeigt und bleibt auf dem Bildschirm des Benutzers, bis er geschlossen wird. Die Audiowiedergabe wird standardmäßig in Schleife ausgeführt, und es wird Alarmaudio verwendet.
  • "incomingCall": Eine Benachrichtigung über eingehende Anrufe. Dies wird in einem speziellen Anrufformat vorab erweitert angezeigt und bleibt auf dem Bildschirm des Benutzers, bis er geschlossen wird. Audio wird standardmäßig in Schleife ausgeführt und verwendet Klingeltonaudio.
  • "dringend" – Eine wichtige Benachrichtigung. Dadurch haben Benutzer mehr Kontrolle darüber, welche Apps ihnen Popupbenachrichtigungen mit hoher Priorität senden können, die den Fokusassistent (Nicht stören) unterbrechen können. Dies kann in den Benachrichtigungseinstellungen geändert werden.

Zeichenfolge Nein Keine
useButtonStyle

Gibt an, ob formatierte Schaltflächen verwendet werden sollen. Das Formatieren der Schaltfläche wird durch das **hint-buttonStyle**-Attribut des aktionselements bestimmt.

boolean Nein false

 

Untergeordnete Elemente

Untergeordnetes Element BESCHREIBUNG
Audio

Gibt einen Sound an, der wiedergegeben werden soll, wenn eine Popupbenachrichtigung angezeigt wird. Dieses Element ermöglicht ihnen auch das Stummschalten beliebiger Toastbenachrichtigungsaudios.

commands

Gibt an, dass die Popupbenachrichtigung verwendet wird, um einen eingehenden Anruf oder einen Alarm anzuzeigen, wobei jedem Szenario entsprechende Befehle zugeordnet sind.

Visual

Enthält ein einzelnes Bindungselement , das ein Popup definiert.

actions

Containerelement zum Deklarieren von bis zu fünf Eingaben und bis zu fünf Schaltflächenaktionen für die Popupbenachrichtigung.

Header

Eingeführt in Creators Update. Gibt einen benutzerdefinierten Header an, der mehrere Benachrichtigungen im Info-Center gruppiert.

 

Übergeordnete Elemente

Dieses äußerste (Dokument)-Element darf nicht in anderen Elementen enthalten sein.

Weitere Informationen