Esquema de contenido de notificaciones del sistema

  • Artículo

A continuación, se describen todas las propiedades y elementos del contenido de la notificación del sistema.

Si prefiere usar XML sin formato en lugar de la biblioteca de notificaciones, consulte el esquema XML.

ToastContent

ToastContent

ToastContent es el objeto de nivel superior que describe el contenido de una notificación, incluidos los objetos visuales, las acciones y el audio.

Propiedad Type Obligatorio Descripción
Inicio string false Cadena que se pasa a la aplicación cuando la notificación del sistema la activa. La aplicación define el formato y el contenido de esta cadena para su propio uso. Cuando el usuario pulsa o hace clic en la notificación del sistema para iniciar su aplicación asociada, la cadena de inicio proporciona el contexto a la aplicación que le permite mostrar al usuario una vista relevante para el contenido de la notificación del sistema, en lugar de iniciarse de forma predeterminada.
Objeto visual ToastVisual true Describe la parte visual de la notificación del sistema.
Acciones IToastActions false Opcionalmente, cree acciones personalizadas con botones y entradas.
Audio ToastAudio false Describe la parte de audio de la notificación del sistema.
ActivationType ToastActivationType false Especifica qué tipo de activación se usará cuando el usuario haga clic en el cuerpo de esta notificación del sistema.
ActivationOptions ToastActivationOptions false Novedad de Creators Update: opciones adicionales relacionadas con la activación de la notificación del sistema.
Escenario ToastScenario false Declara el escenario para el que se usa la notificación del sistema, como una alarma o un recordatorio.
DisplayTimestamp ¿DateTimeOffset? false Novedad de Creators Update: puede invalidar la marca de tiempo predeterminada con una marca de tiempo personalizada que indique cuándo se entregó realmente el contenido de la notificación, en lugar de la hora en que la plataforma Windows recibió la notificación.
Encabezado ToastHeader false Novedad de Creators Update: puede agregar un encabezado personalizado a la notificación para agrupar varias notificaciones en el Centro de actividades.

ToastScenario

Especifica qué escenario representa la notificación del sistema.

Value Significado
Valor predeterminado Comportamiento normal de la notificación del sistema.
Recordatorio Notificación de recordatorio. Se mostrará previamente expandido y permanecerá en la pantalla del usuario hasta que se ignore.
Alarma Notificación de alarma. Se mostrará previamente expandido y permanecerá en la pantalla del usuario hasta que se ignore. El audio se repetirá de manera predeterminada y utilizará audio de alarma.
IncomingCall Notificación de llamada entrante. Se muestra previamente expandida en un formato de llamada especial y permanece en la pantalla del usuario hasta que se ignora. El audio se repetirá de manera predeterminada y utilizará el audio del tono.

ToastVisual

Esta parte visual de las notificaciones del sistema contiene los enlaces que a su vez contienen texto, imágenes, contenido adaptable, etc.

Propiedad Type Obligatorio Descripción
BindingGeneric ToastBindingGeneric true Es el enlace genérico de notificación del sistema que se puede representar en todos los dispositivos. Este enlace es necesario y no puede tener el valor NULL.
BaseUri Uri false Es una dirección URL base predeterminada que se combina con direcciones URL relativas en atributos de origen de imagen.
AddImageQuery ¿Valor booleano? false Establézcalo en "true" para permitir que Windows anexe una cadena de consulta a la dirección URL de la imagen proporcionada en la notificación del sistema. Use este atributo si el servidor hospeda imágenes y puede controlar las cadenas de consulta, ya sea recuperando una variante de imagen basada en las cadenas de consulta o ignorando la cadena de consulta y devolviendo la imagen tal como se especifica sin la cadena de consulta. Esta cadena de consulta especifica la escala, la configuración de contraste y el idioma; por ejemplo, un valor de "www.website.com/images/hello.png" dado en la notificación se convierte en "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".
Lenguaje string false Configuración regional de destino de la carga visual cuando se usan recursos localizados que se han especificado como etiquetas de idioma BCP-47 como "en-US" o "fr-FR". Esta configuración regional se invalida mediante cualquier configuración regional especificada en el enlace o texto. Si no se proporciona, se usará la configuración regional del sistema en su lugar.

ToastBindingGeneric

El enlace genérico es el enlace predeterminado para las notificaciones del sistema y es donde se especifican el texto, las imágenes, el contenido adaptable, etc.

Propiedad Type Obligatorio Descripción
Children IList<IToastBindingGenericChild> false Contenido del cuerpo de la notificación del sistema, que puede incluir texto, imágenes y grupos (agregados en actualización de aniversario). Los elementos de texto deben aparecer antes de cualquier otro elemento y solo se admiten 3 elementos de texto. Si un elemento de texto se coloca después de cualquier otro elemento, se extraerá en la parte superior o se quitará. Por último, algunas propiedades de texto como HintStyle no se admiten en los elementos de texto secundarios raíz y solo funcionan dentro de un elemento adaptiveSubgroup. Si usa AdaptiveGroup en dispositivos sin la actualización de aniversario, simplemente se quitará el contenido del grupo.
AppLogoOverride ToastGenericAppLogo false Logotipo opcional para invalidar el logotipo de la aplicación.
HeroImage ToastGenericHeroImage false Imagen "Elemento principal" destacada opcional que se muestra en la notificación del sistema y en el Centro de actividades.
Attribution ToastGenericAttributionText false Texto de atribución opcional que se mostrará en la parte inferior de la notificación del sistema.
BaseUri Uri false Es una dirección URL base predeterminada que se combina con direcciones URL relativas en atributos de origen de imagen.
AddImageQuery ¿Valor booleano? false Establézcalo en "true" para permitir que Windows anexe una cadena de consulta a la dirección URL de la imagen proporcionada en la notificación del sistema. Use este atributo si el servidor hospeda imágenes y puede controlar las cadenas de consulta, ya sea recuperando una variante de imagen basada en las cadenas de consulta o ignorando la cadena de consulta y devolviendo la imagen tal como se especifica sin la cadena de consulta. Esta cadena de consulta especifica la escala, la configuración de contraste y el idioma; por ejemplo, un valor de "www.website.com/images/hello.png" dado en la notificación se convierte en "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".
Lenguaje string false Configuración regional de destino de la carga visual cuando se usan recursos localizados que se han especificado como etiquetas de idioma BCP-47 como "en-US" o "fr-FR". Esta configuración regional se invalida mediante cualquier configuración regional especificada en el enlace o texto. Si no se proporciona, se usará la configuración regional del sistema en su lugar.

IToastBindingGenericChild

Interfaz de marcador para elementos secundarios de la notificación del sistema que incluyen texto, imágenes, grupos y mucho más.

Implementaciones
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

Elemento de texto adaptable. Si se coloca en el nivel superior ToastBindingGeneric.Children, solo se aplicará el elemento HintMaxLines. Pero si se coloca como elemento secundario de un grupo o subgrupo, se admite el estilo de texto completo.

Propiedad Type Obligatorio Descripción
Texto cadena o BindableString false Texto que se mostrará. Se ha agregado compatibilidad con enlaces de datos en Creators Update, pero solo funciona para elementos de texto de nivel superior.
HintStyle AdaptiveTextStyle false El estilo controla el tamaño de fuente, el peso y la opacidad del texto. Solo funciona con los elementos de texto dentro de un grupo o subgrupo.
HintWrap ¿Valor booleano? false Establézcalo en "true" para habilitar el ajuste de texto. Los elementos de texto de nivel superior omiten esta propiedad y siempre se ajustan (puede usar HintMaxLines = 1 para deshabilitar el ajuste de los elementos de texto de nivel superior). Los elementos de texto que están dentro de grupos o subgrupos se establecen de forma predeterminada en "false" para su ajuste.
HintMaxLines ¿Valor int? false Número máximo de líneas que puede mostrar el elemento de texto.
HintMinLines ¿Valor int? false Número mínimo de líneas que debe mostrar el elemento de texto. Solo funciona con los elementos de texto dentro de un grupo o subgrupo.
HintAlign AdaptiveTextAlign false Alineación horizontal del texto. Solo funciona con los elementos de texto dentro de un grupo o subgrupo.
Lenguaje string false Configuración regional de destino de la carga XML especificada como etiquetas de lenguaje BCP-47 como "en-US" o "fr-FR". La configuración regional especificada aquí invalida cualquier otra configuración regional especificada, como la del enlace o el objeto visual. Si este valor es una cadena literal, este atributo tiene como valor predeterminado el idioma de la interfaz de usuario. Si este valor es una referencia de cadena, este atributo tiene como valor predeterminado la configuración regional que ha elegido Windows Runtime para resolver la cadena.

BindableString

Valor de enlace para cadenas.

Propiedad Type Obligatorio Descripción
BindingName string true Obtiene o establece el nombre que se asigna al valor de datos de enlace.

AdaptiveTextStyle

El estilo de texto controla el tamaño de fuente, el peso y la opacidad. La opacidad tenue es un 60 % opaca.

Value Significado
Valor predeterminado Valor predeterminado. El representador determina el estilo.
Caption Menor que el tamaño de fuente del párrafo.
CaptionSubtle Igual que el subtítulo, pero con opacidad tenue.
Cuerpo Tamaño de fuente del párrafo.
BodySubtle Igual que el cuerpo, pero con opacidad tenue.
Base Tamaño de fuente del párrafo; peso en negrita. Básicamente, la versión en negrita del cuerpo.
BaseSubtle Igual que la base, pero con opacidad tenue.
Subtítulo Tamaño de fuente H4.
SubtitleSubtle Igual que el subtítulo, pero con opacidad tenue.
Título Tamaño de fuente H3.
TitleSubtle Igual que el título, pero con opacidad tenue.
TitleNumeral Igual que el título, pero sin el relleno superior/inferior.
Subheader Tamaño de fuente H2.
SubheaderSubtle Igual que el encabezado secundario, pero con opacidad tenue.
SubheaderNumeral Igual que el encabezado secundario, pero si el relleno superior/inferior.
Encabezado Tamaño de fuente H1.
HeaderSubtle Igual que el encabezado, pero con opacidad tenue.
HeaderNumeral Igual que el encabezado, pero sin el relleno superior/inferior.

AdaptiveTextAlign

Controla la alineación horizontal del texto.

Value Significado
Valor predeterminado Valor predeterminado. El representador determina automáticamente la alineación.
Automático El idioma y la referencia cultural actuales determinan la alineación.
Izquierdo Permite alinear horizontalmente el texto a la izquierda.
de las instalaciones Permite alinear horizontalmente el texto en el centro.
Derecho Permite alinear horizontalmente el texto a la derecha.

AdaptiveImage

Imagen alineada.

Propiedad Type Obligatorio Descripción
Origen string true Dirección URL de la imagen. Se admiten los valores ms-appx, ms-appdata y http. En Fall Creators Update, las imágenes web pueden tener hasta 3 MB en conexiones normales y 1 MB en conexiones de uso medido. En los dispositivos que aún no ejecutan Fall Creators Update, las imágenes web no deben tener más de 200 KB.
HintCrop AdaptiveImageCrop false Novedad de la actualización de aniversario: controle el recorte deseado de la imagen.
HintRemoveMargin ¿Valor booleano? false De forma predeterminada, las imágenes dentro de grupos o subgrupos tienen un margen de 8 px alrededor. Si quiere quitar ese margen, establezca esta propiedad en "true".
HintAlign AdaptiveImageAlign false Alineación horizontal de la imagen. Solo funciona para imágenes dentro de un grupo o subgrupo.
AlternateText string false Texto alternativo que describe la imagen, que se usa con fines de accesibilidad.
AddImageQuery ¿Valor booleano? false Establézcalo en "true" para permitir que Windows anexe una cadena de consulta a la dirección URL de la imagen proporcionada en la notificación del sistema. Use este atributo si el servidor hospeda imágenes y puede controlar las cadenas de consulta, ya sea recuperando una variante de imagen basada en las cadenas de consulta o ignorando la cadena de consulta y devolviendo la imagen tal como se especifica sin la cadena de consulta. Esta cadena de consulta especifica la escala, la configuración de contraste y el idioma; por ejemplo, un valor de "www.website.com/images/hello.png" dado en la notificación se convierte en "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".

AdaptiveImageCrop

Especifica el recorte deseado de la imagen.

Value Significado
Valor predeterminado Valor predeterminado. El representador determina el comportamiento del recorte.
Ninguno La imagen no se recorta.
Círculo La imagen se recorta en forma de círculo.

AdaptiveImageAlign

Especifica la alineación horizontal de una imagen.

Value Significado
Valor predeterminado Valor predeterminado. El representador determina el comportamiento de la alineación.
Stretch La imagen se ajuta para rellenar el ancho disponible (y el alto posiblemente disponible también, dependiendo de dónde se coloque la imagen).
Izquierdo Alinee la imagen a la izquierda y muestre la imagen en su resolución nativa.
de las instalaciones Alinee la imagen en el centro horizontalmente y muestre la imagen en su resolución nativa.
Derecho Alinee la imagen a la derecha y muestre la imagen en su resolución nativa.

AdaptiveGroup

Novedad de la actualización de aniversario: los grupos identifican semánticamente que el contenido del grupo debe mostrarse completamente o no mostrarse si no hay espacio. Los grupos también permiten crear varias columnas.

Propiedad Type Obligatorio Descripción
Children IList<AdaptiveSubgroup> false Los subgrupos se muestran como columnas verticales. Debe usar subgrupos para proporcionar cualquier contenido dentro de un elemento AdaptiveGroup.

AdaptiveSubgroup

Novedad de la actualización de aniversario: los subgrupos son columnas verticales que pueden contener texto e imágenes.

Propiedad Type Obligatorio Descripción
Children IList<IAdaptiveSubgroupChild> false AdaptiveText y AdaptiveImage son elementos secundarios válidos de subgrupos.
HintWeight ¿Valor int? false Si quiere controlar el ancho de esta columna de subgrupo, especifique el peso en relación con otros subgrupos.
HintTextStacking AdaptiveSubgroupTextStacking false Permite controlar la alineación vertical del contenido de este subgrupo.

IAdaptiveSubgroupChild

Interfaz de marcador para los elementos secundarios del subgrupo.

Implementaciones
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking especifica la alineación vertical del contenido.

Value Significado
Valor predeterminado Valor predeterminado. El representador selecciona automáticamente la alineación vertical predeterminada.
Top (Principales) Permite alinear verticalmente en la parte superior.
de las instalaciones Permite alinear verticalmente en el centro.
Bottom Permite alinear verticalmente en la parte inferior.

AdaptiveProgressBar

Novedades de Creators Update: barra de progreso. Solo se admite en notificaciones del sistema del escritorio (compilación 15063 o posterior).

Propiedad Type Obligatorio Description
Título cadena o BindableString false Obtiene o establece una cadena de título opcional. Es compatible con el enlace de datos.
Valor doble o AdaptiveProgressBarValue o BindableProgressBarValue false Obtiene o establece el valor de la barra de progreso. Es compatible con el enlace de datos. El valor predeterminado es 0.
ValueStringOverride cadena o BindableString false Obtiene o establece la cadena opcional que se va a mostrar en lugar de la cadena de porcentaje predeterminada. Si no se proporciona, se mostrará algo parecido a "70 %".
Estado cadena o BindableString true Obtiene o establece una cadena de estado (obligatoria), que se muestra debajo de la barra de progreso de la izquierda. Esta cadena debe reflejar el estado de la operación, como "Descargando..." o "Instalando..."

AdaptiveProgressBarValue

Clase que representa el valor de la barra de progreso.

Propiedad Type Obligatorio Description
Valor doble false Obtiene o establece el valor (0,0 - 1,0) que representa el porcentaje completado.
IsIndeterminate bool false Obtiene o establece un valor que indica si la barra de progreso es indeterminada. Si esto es “true”, se omitirá el elemento Value.

BindableProgressBarValue

Valor de barra de progreso enlazable.

Propiedad Type Obligatorio Descripción
BindingName string true Obtiene o establece el nombre que se asigna al valor de datos de enlace.

Logotipo que se va a mostrar en lugar del logotipo de la aplicación.

Propiedad Type Obligatorio Descripción
Origen string true Dirección URL de la imagen. Se admiten los valores ms-appx, ms-appdata y http. Las imágenes HTTP deben tener un tamaño de 200 KB o menos.
HintCrop ToastGenericAppLogoCrop false Permite especificar cómo quiere recortar la imagen.
AlternateText string false Texto alternativo que describe la imagen, que se usa con fines de accesibilidad.
AddImageQuery ¿Valor booleano? false Establézcalo en "true" para permitir que Windows anexe una cadena de consulta a la dirección URL de la imagen proporcionada en la notificación del sistema. Use este atributo si el servidor hospeda imágenes y puede controlar las cadenas de consulta, ya sea recuperando una variante de imagen basada en las cadenas de consulta o ignorando la cadena de consulta y devolviendo la imagen tal como se especifica sin la cadena de consulta. Esta cadena de consulta especifica la escala, la configuración de contraste y el idioma; por ejemplo, un valor de "www.website.com/images/hello.png" dado en la notificación se convierte en "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".

ToastGenericAppLogoCrop

Controla el recorte de la imagen del logotipo de la aplicación.

Value Significado
Valor predeterminado El recorte usa el comportamiento predeterminado del representador.
Ninguno La imagen no se recorta y se muestra cuadrada.
Círculo La imagen se recorta en forma de círculo.

ToastGenericHeroImage

Imagen "Elemento principal" destacada que se muestra en la notificación del sistema y en el Centro de actividades.

Propiedad Type Obligatorio Descripción
Origen string true Dirección URL de la imagen. Se admiten los valores ms-appx, ms-appdata y http. Las imágenes HTTP deben tener un tamaño de 200 KB o menos.
AlternateText string false Texto alternativo que describe la imagen, que se usa con fines de accesibilidad.
AddImageQuery ¿Valor booleano? false Establézcalo en "true" para permitir que Windows anexe una cadena de consulta a la dirección URL de la imagen proporcionada en la notificación del sistema. Use este atributo si el servidor hospeda imágenes y puede controlar las cadenas de consulta, ya sea recuperando una variante de imagen basada en las cadenas de consulta o ignorando la cadena de consulta y devolviendo la imagen tal como se especifica sin la cadena de consulta. Esta cadena de consulta especifica la escala, la configuración de contraste y el idioma; por ejemplo, un valor de "www.website.com/images/hello.png" dado en la notificación se convierte en "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us".

ToastGenericAttributionText

Texto de atribución que se muestra en la parte inferior de la notificación del sistema.

Propiedad Type Obligatorio Descripción
Texto string true Texto que se mostrará.
Lenguaje string false Configuración regional de destino de la carga visual cuando se usan recursos localizados que se han especificado como etiquetas de idioma BCP-47 como "en-US" o "fr-FR". Si no se proporciona, se usará la configuración regional del sistema en su lugar.

IToastActions

Interfaz de marcador para acciones o entradas de notificaciones del sistema.

Implementaciones
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

Implementa IToastActions

Permite crear sus propias acciones y entradas personalizadas mediante controles como botones, cuadros de texto y entradas de selección.

Propiedad Type Obligatorio Descripción
Entradas IList<IToastInput> false Entradas como cuadros de texto y entradas de selección. Solo se permiten hasta 5 entradas.
Botones IList<IToastButton> false Los botones se muestran después de todas las entradas (o adyacentes a una entrada si el botón se usa como un botón de respuesta rápida). Solo se permiten hasta 5 botones (o menos si también tiene elementos de menú contextual).
ContextMenuItems IList<ToastContextMenuItem> false Novedad de la actualización de aniversario: los elementos de menú contextual personalizados proporcionan acciones adicionales si el usuario hace clic con el botón derecho en la notificación. Solo puede tener hasta 5 botones y elementos de menú contextual combinados.

IToastInput

Interfaz de marcador para entradas de notificaciones del sistema.

Implementaciones
ToastTextBox
ToastSelectionBox

ToastTextBox

Implementa IToastInput

El control de cuadro de texto permite a un usuario escribir texto.

Propiedad Type Obligatorio Descripción
Id string true El identificador es necesario y se usa para asignar el texto que ha introducido el usuario en un par clave-valor de tipo id./valor que la aplicación consume más adelante.
Título string false Texto del título que se mostrará encima del cuadro de texto.
PlaceholderContent string false Texto de marcador de posición que se muestra en el cuadro de texto cuando el usuario aún no ha escrito ningún texto.
DefaultInput string false Texto inicial que se colocará en el cuadro de texto. Deje este valor "NULL" para un cuadro de texto en blanco.

ToastSelectionBox

Implementa IToastInput

Es un control de cuadro de selección, que permite a los usuarios elegir entre una lista desplegable de opciones.

Propiedad Type Obligatorio Descripción
Id string true El id. es obligatorio. Si el usuario seleccionó este elemento, el id. se volverá al código de la aplicación, que representa la selección que eligió.
Contenido string true El contenido es necesario y es una cadena que se muestra en el elemento de selección.

ToastSelectionBoxItem

Elemento de cuadro de selección (es un elemento que el usuario puede seleccionar en la lista desplegable).

Propiedad Type Obligatorio Descripción
Id string true El identificador es necesario y se usa para asignar el texto que ha introducido el usuario en un par clave-valor de tipo id./valor que la aplicación consume más adelante.
Título string false Texto del título que se mostrará encima del cuadro de selección.
DefaultSelectionBoxItemId string false Controla qué elemento está seleccionado de forma predeterminada y hace referencia a la propiedad de id. del elemento ToastSelectionBoxItem. Si no proporciona este valor, la selección predeterminada quedará vacía y el usuario no verá nada.
Artículos IList<ToastSelectionBoxItem> false Son los elementos de selección que el usuario puede seleccionar en este elemento SelectionBox. Solo se pueden agregar 5 elementos.

IToastButton

Interfaz de marcador para los botones de las notificaciones del sistema.

Implementaciones
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implementa IToastButton

Botón en el que el usuario puede hacer clic.

Propiedad Type Obligatorio Descripción
Contenido string true Necesario. Texto que se va a mostrar en el botón.
Argumentos string true Necesario. Cadena de argumentos definida por la aplicación y que esta recibirá más adelante si el usuario hace clic en este botón.
ActivationType ToastActivationType false Controla qué tipo de activación usará este botón al hacer clic. El valor predeterminado es Primer plano.
ActivationOptions ToastActivationOptions false Novedad de Creators Update: obtiene o establece opciones adicionales relacionadas con la activación del botón de notificaciones del sistema.

ToastActivationType

Decide el tipo de activación que se usará cuando el usuario interactúe con una acción específica.

Value Significado
Primer plano Valor predeterminado. Se inicia la aplicación en primer plano.
Fondo Se desencadena la tarea en segundo plano correspondiente (suponiendo que tenga todo configurado) y puede ejecutar el código en segundo plano (por ejemplo, enviar un mensaje de respuesta rápida del usuario) sin interrumpir al usuario.
Protocolo Inicie otra aplicación mediante la activación del protocolo.

ToastActivationOptions

Novedad de Creators Update: opciones adicionales relacionadas con la activación.

Propiedad Type Obligatorio Descripción
AfterActivationBehavior ToastAfterActivationBehavior false Novedad de Fall Creators Update: obtiene o establece el comportamiento que la notificación del sistema debe usar cuando el usuario invoca esta acción. Esto solo funciona en el escritorio, para ToastButton y ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn string false Si usa ToastActivationType.Protocol, tiene la opción de especificar el PFN de destino para que la aplicación deseada siempre se inicie, independientemente de si tiene varias aplicaciones registradas para controlar el mismo URI de protocolo.

ToastAfterActivationBehavior

Especifica el comportamiento que debe usar la notificación del sistema cuando el usuario realiza una acción en la notificación del sistema.

Value Significado
Valor predeterminado Comportamiento predeterminado. La notificación del sistema se ignorará 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 de la notificación del sistema, esta permanecerá visible, con un estado de "actualización pendiente". Debe actualizar inmediatamente la notificación del sistema desde una tarea en segundo plano para que el usuario no vea el estado visual "actualización pendiente" durante demasiado tiempo.

ToastButtonSnooze

Implementa IToastButton

Es un botón de posponer que controla el sistema y que administra automáticamente la posposición de la notificación.

Propiedad Type Obligatorio Descripción
CustomContent string false Texto personalizado opcional que se muestra en el botón que invalida el texto "Posponer" localizado predeterminado.

ToastButtonDismiss

Implementa IToastButton

Un botón para ignorar elementos que controla el sistema y que ignora la notificación cuando se hace clic en él.

Propiedad Type Obligatorio Descripción
CustomContent string false Texto personalizado opcional que se muestra en el botón que invalida el texto "Ignorar" localizado predeterminado.

ToastActionsSnoozeAndDismiss

* Implementa IToastActions

Construye automáticamente un cuadro de selección para intervalos de posposición y los botones Posponer o Ignorar; todo se localiza automáticamente y la lógica de posposición la controla el sistema automáticamente.

Propiedad Type Obligatorio Descripción
ContextMenuItems IList<ToastContextMenuItem> false Novedad de la actualización de aniversario: los elementos de menú contextual personalizados proporcionan acciones adicionales si el usuario hace clic con el botón derecho en la notificación. Solo puede tener hasta 5 elementos.

ToastContextMenuItem

Una entrada de elemento de menú contextual.

Propiedad Type Obligatorio Descripción
Contenido string true Necesario. Texto que se mostrará.
Argumentos string true Necesario. Cadena que define la aplicación de argumentos y que la aplicación puede recuperar más adelante una vez se activa cuando el usuario hace clic en el elemento de menú.
ActivationType ToastActivationType false Controla qué tipo de activación utilizará este elemento de menú cuando se haga clic en él. El valor predeterminado es Primer plano.
ActivationOptions ToastActivationOptions false Novedad de Creators Update: opciones adicionales relacionadas con la activación del elemento de menú contextual de la notificación del sistema.

ToastAudio

Permite especificar el audio que se reproducirá cuando se reciba la notificación del sistema.

Propiedad Type Obligatorio Descripción
Src uri false Archivo multimedia que se va a reproducir en lugar del sonido predeterminado. Solo se admiten los elementos ms-appx y ms-resource. El resto no se admite (ms-appdata, http, C:, etc.).
Loop boolean false Establézcalo en "true" si el sonido debe repetirse siempre que se muestre la notificación del sistema y en "false" para reproducirlo solo una vez (valor predeterminado).
Silent boolean false Establézcalo en "true" para silenciar el sonido y en "false" para permitir que el sonido de la notificación del sistema se reproduzca (valor predeterminado).

ToastHeader

Novedad de Creators Update: encabezado personalizado que agrupa varias notificaciones en el Centro de actividades.

Propiedad Type Obligatorio Descripción
Id string true Identificador creado por el desarrollador que identifica de forma única este encabezado. Si dos notificaciones tienen el mismo id. de encabezado, se mostrarán debajo del mismo encabezado en el Centro de actividades.
Título string true Título del encabezado.
Argumentos string true Obtiene o establece una cadena de argumentos que define el desarrollador y que se devuelve a la aplicación cuando el usuario hace clic en este encabezado. No puede ser null.
ActivationType ToastActivationType false Obtiene o establece el tipo de activación que usará este encabezado cuando se haga clic en él. El valor predeterminado es Primer plano. Tenga en cuenta que solo se admiten los elementos Primer plano y Protocolo.
ActivationOptions ToastActivationOptions false Obtiene o establece opciones adicionales relacionadas con la activación del encabezado de notificaciones del sistema.