Compartir a través de

acción (esquema XML del sistema)

  • Artículo

Especifica un botón que se muestra en una notificación del sistema.

Jerarquía de elemento

<Brindis>
<Acciones>
<Entrada>

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
/>

Clave

? opcional (cero o uno)

Atributos y elementos

Atributos

Atributo Descripción Tipo de datos Obligatorio Valor predeterminado
contenido Contenido que se muestra en el botón. string Sí None
argumentos Cadena de argumentos definida por la aplicación que la aplicación recibirá más adelante si el usuario hace clic en este botón. string Sí None
tipo Cadena de argumento que se puede pasar a la aplicación asociada para proporcionar detalles sobre la acción que debe ejecutar en respuesta a la acción del usuario. string Sí None
activationType Decide el tipo de activación que se usará cuando el usuario interactúe con una acción específica.
  • "primer plano": valor predeterminado. Se inicia la aplicación en primer plano.
  • "background": la tarea en segundo plano correspondiente se desencadena y puede ejecutar código en segundo plano sin interrumpir al usuario.
  • "protocolo": inicie una aplicación diferente mediante la activación del protocolo.
 string No "primer plano"
afterActivationBehavior Especifica el comportamiento que la notificación del sistema debe usar cuando el usuario realiza una acción en la notificación del sistema.
  • "default": valor predeterminado. La notificación del sistema se descartará cuando el usuario realice una acción en la notificación del sistema.
  • "pendingUpdate" - Después de que el usuario haga clic en un botón en el sistema, la notificación permanecerá presente, en un estado visual de "actualización pendiente". Debe actualizar inmediatamente la notificación del sistema desde una tarea en segundo plano para que el usuario no vea este estado visual de "actualización pendiente" durante demasiado tiempo.
 string No "predeterminado"
selección de ubicación Cuando se establece en "contextMenu", la acción se convierte en una acción de menú contextual agregada al menú contextual de la notificación del sistema en lugar de un botón de notificación del sistema tradicional. string No None
imageUri El URI del origen de la imagen para un icono de botón de notificación del sistema. Estos iconos son imágenes transparentes de 16 x 16 píxeles en blanco con un escalado del 100 % y no deben tener relleno incluido en la propia imagen. Si decide proporcionar iconos en una notificación del sistema, debe proporcionar iconos para todos los botones de la notificación, ya que transforma el estilo de los botones en botones de icono. Use uno de los siguientes controladores de protocolo:
  • http:// o https://: una imagen basada en web.
  • ms-appx:/// : imagen incluida en el paquete de la aplicación.
  • ms-appdata:///local/ : imagen guardada en el almacenamiento local.
  • file:///: una imagen local. (Solo se admite para aplicaciones de escritorio. Las aplicaciones para UWP no pueden usar este protocolo).
 string No None
hint-inputId Establezca en el identificador de una entrada para colocar el botón situado junto a la entrada. string No None
hint-buttonStyle Estilo del botón. useButtonStyle debe establecerse en true en el elemento toast .
  • "Correcto": el botón es verde
  • "Crítico": el botón es rojo.
Tenga en cuenta que estos valores distinguen mayúsculas de minúsculas.		 string No None
hint-toolTip La información sobre herramientas de un botón, si el botón tiene una cadena de contenido vacía. string No None

Elementos secundarios

Ninguno

Elementos primarios

Elemento primario Descripción
actions Elemento contenedor para declarar hasta cinco entradas y hasta cinco acciones de botón para la notificación del sistema.

Consulte también