Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
A continuación se describen todas las propiedades y elementos del contenido de la notificación del sistema.
Si prefiere usar XML en bruto en lugar de la biblioteca de notificaciones , consulte el esquema XML .
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.
| Property | Type | Required | Description |
|---|---|---|---|
| Launch | string | false | Una cadena que se pasa a la aplicación cuando la activa el Toast. 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 emergente para iniciar su aplicación asociada, el parámetro 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 emergente, en lugar de iniciarse de forma predeterminada. |
| Visual | ToastVisual | true | Describe la parte visual de la notificación emergente. |
| Actions | IToastActions | false | Opcionalmente, cree acciones personalizadas con botones y entradas. |
| Audio | ToastAudio | false | Describe la parte de audio de la notificación toast. |
| ActivationType | ToastActivationType | false | Especifica qué tipo de activación se usará cuando el usuario haga clic en el cuerpo de este Toast. |
| ActivationOptions | ToastActivationOptions | false | Novedades en Creators Update: Opciones adicionales para la activación de la notificación emergente. |
| Scenario | 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: invalide la marca de tiempo predeterminada con una marca de tiempo personalizada que representa 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. |
| Header | ToastHeader | false | Novedad de Creators Update: agregue un encabezado personalizado a la notificación para agrupar varias notificaciones en el Centro de actividades. |
ToastScenario
Especifica qué escenario representa la notificación.
| Value | Meaning |
|---|---|
| Default | Comportamiento normal de la notificación del sistema. |
| Reminder | Una notificación de recordatorio. Esto se mostrará previamente expandido y permanecerá en la pantalla del usuario hasta que se descarte. |
| Alarm | Una notificación de alarma. Esto se mostrará previamente expandido y permanecerá en la pantalla del usuario hasta que se descarte. El audio se repetirá de forma predeterminada y usará audio de alarma. |
| IncomingCall | Una notificación de llamada entrante. Esto se mostrará previamente expandido en un formato de llamada especial y permanecerá en la pantalla del usuario hasta que se descarte. El audio se repetirá de forma predeterminada y utilizará el tono de llamada. |
ToastVisual
La parte visual de las notificaciones del sistema contiene los enlaces, que contiene texto, imágenes, contenido adaptable, etc.
| Property | Type | Required | Description |
|---|---|---|---|
| BindingGeneric | ToastBindingGeneric | true | La vinculación de brindis genérica, que se puede representar en todos los dispositivos. Esta vinculación es necesaria y no puede ser nulo. |
| BaseUri | Uri | false | Dirección URL base predeterminada que se combina con direcciones URL relativas en atributos de origen de imagen. |
| AddImageQuery | bool? | 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 emergente. 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 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" |
| Language | string | false | La configuración regional de destino de la carga visual, como cuando se usan recursos localizados, se especifica mediante etiquetas de idioma BCP-47 como "en-US" o "fr-FR". Esta configuración regional se invalida por cualquier configuración regional especificada en la vinculación o el texto. Si no se proporciona, la configuración regional del sistema se usará 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.
| Property | Type | Required | Description |
|---|---|---|---|
| Children | IList<IToastBindingGenericChild> | false | Contenido del cuerpo de la notificación emergente, que puede incluir texto, imágenes y grupos (agregados en la 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 moverá hacia la parte superior o se desplazará hacia abajo. Por último, algunas propiedades de texto como HintStyle no se admiten en los elementos de texto principales y solo funcionan dentro de un 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 de "héroe" 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 emergente. |
| BaseUri | Uri | false | Dirección URL base predeterminada que se combina con direcciones URL relativas en atributos de origen de imagen. |
| AddImageQuery | bool? | 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 emergente. 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 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" |
| Language | string | false | La configuración regional de destino de la carga visual, como cuando se usan recursos localizados, se especifica mediante etiquetas de idioma BCP-47 como "en-US" o "fr-FR". Esta configuración regional se invalida por cualquier configuración regional especificada en la vinculación o el texto. Si no se proporciona, la configuración regional del sistema se usará en su lugar. |
IToastBindingGenericChild
Interfaz de marcador para elementos secundarios de notificación que incluyen texto, imágenes, grupos y mucho más.
| Implementations |
|---|
| AdaptiveText |
| AdaptiveImage |
| AdaptiveGroup |
| AdaptiveProgressBar |
AdaptiveText
Un elemento de texto adaptable. Si se coloca en el nivel superior ToastBindingGeneric.Children, solo se aplicará HintMaxLines. Pero si se coloca como elemento secundario de un grupo o subgrupo, se admite el estilo de texto completo.
| Property | Type | Required | Description |
|---|---|---|---|
| Text | cadena o BindableString | false | Texto que se va a 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 para los elementos de texto dentro de un grupo o subgrupo. |
| HintWrap | bool? | false | Establézcalo en true para habilitar el ajuste de texto. Los elementos de texto de nivel superior omiten esta propiedad y siempre se distribuyen (puede usar HintMaxLines = 1 para deshabilitar la distribución de los elementos de texto de nivel superior). Los elementos de texto dentro de grupos o subgrupos se establecen como falsos por defecto para el ajuste. |
| HintMaxLines | int? | false | El número máximo de líneas que puede mostrar el elemento de texto. |
| HintMinLines | int? | false | Número mínimo de líneas que debe mostrar el elemento de texto. Solo funciona para los elementos de texto dentro de un grupo o subgrupo. |
| HintAlign | AdaptiveTextAlign | false | Alineación horizontal del texto. Solo funciona para los elementos de texto dentro de un grupo o subgrupo. |
| Language | string | false | Localización de destino de la carga XML, especificada como etiquetas de idioma BCP-47 como "en-US" o "fr-FR". La configuración regional especificada aquí invalida cualquier otra configuración regional especificada, como la de la vinculación o el componente visual. Si este valor es una cadena literal, este atributo tiene como valor predeterminado el idioma de la interfaz de usuario del usuario. Si este valor es una referencia de cadena, este atributo tiene como valor predeterminado la configuración regional elegida por Windows Runtime para resolver la cadena. |
BindableString
Valor de enlace para cadenas.
| Property | Type | Required | Description |
|---|---|---|---|
| BindingName | string | true | Obtiene o establece el nombre que corresponde a su valor de datos de enlace. |
AdaptiveTextStyle
El estilo de texto controla el tamaño de fuente, el peso y la opacidad. La opacidad sutil es de un 60%, con el código de color%.
| Value | Meaning |
|---|---|
| Default | Valor predeterminado. El representador determina el estilo. |
| Caption | Menor que el tamaño de fuente del párrafo. |
| CaptionSubtle | Igual que Caption, pero con opacidad sutil. |
| Body | Tamaño de fuente del párrafo. |
| BodySubtle | Igual que Cuerpo, pero con opacidad sutil. |
| Base | Tamaño de fuente del párrafo, peso en negrita. Básicamente, la versión en negrita de Body. |
| BaseSubtle | Igual que Base, pero con opacidad sutil. |
| Subtitle | Tamaño de fuente H4. |
| SubtitleSubtle | Igual que el subtítulo, pero con opacidad sutil. |
| Title | Tamaño de fuente H3. |
| TitleSubtle | Igual que el título, pero con una opacidad sutil. |
| TitleNumeral | Igual que el título, pero sin el espaciado superior/inferior. |
| Subheader | Tamaño de fuente H2. |
| SubheaderSubtle | Igual que el subtítulo, pero con una opacidad sutil. |
| SubheaderNumeral | Igual que subtítulo, pero sin relleno arriba/abajo. |
| Header | Tamaño de fuente H1. |
| HeaderSubtle | Igual que el encabezado, pero con una opacidad ligera. |
| HeaderNumeral | Igual que el encabezado, pero con el margen superior/inferior eliminado. |
AdaptiveTextAlign
Controla la alineación horizontal del texto.
| Value | Meaning |
|---|---|
| Default | Valor predeterminado. El representador determina automáticamente la alineación. |
| Auto | Alineación determinada por el idioma y la cultura actuales. |
| Left | Alinee horizontalmente el texto a la izquierda. |
| Center | Alinee horizontalmente el texto en el centro. |
| Right | Alinee horizontalmente el texto a la derecha. |
AdaptiveImage
Imagen insertada.
| Property | Type | Required | Description |
|---|---|---|---|
| Source | string | true | Dirección URL de la imagen. se admiten ms-appx, ms-appdata y http. A partir de la actualización Fall Creators, las imágenes web pueden tener hasta 3 MB en conexiones normales y 1 MB en conexiones medidas. 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 | bool? | false | De forma predeterminada, las imágenes dentro de grupos o subgrupos tienen un margen de 8px alrededor de ellos. Puede quitar este margen estableciendo 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 | bool? | 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 emergente. 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 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 | Meaning |
|---|---|
| Default | Valor predeterminado. Comportamiento de recorte determinado por el motor de renderizado. |
| None | La imagen no se recorta. |
| Circle | La imagen se recorta en una forma de círculo. |
AdaptiveImageAlign
Especifica la alineación horizontal de una imagen.
| Value | Meaning |
|---|---|
| Default | Valor predeterminado. Comportamiento de alineación determinado por el representador. |
| Stretch | La imagen se extiende para rellenar el ancho disponible (y el alto posiblemente disponible también, dependiendo de dónde se coloque la imagen). |
| Left | Alinee la imagen a la izquierda y muestre la imagen en su resolución nativa. |
| Center | Alinee la imagen en el centro horizontalmente y muestre la imagen en su resolución nativa. |
| Right | Alinee la imagen a la derecha y muestre la imagen en su resolución nativa. |
AdaptiveGroup
Novedades de la Actualización de Aniversario: los grupos identifican semánticamente que el contenido del grupo debe mostrarse como un todo, o no mostrarse si no puede caber. Los grupos también permiten crear varias columnas.
| Property | Type | Required | Description |
|---|---|---|---|
| Children | IList<AdaptiveSubgroup> | false | Los subgrupos se muestran como columnas verticales. Debe usar subgrupos para proporcionar cualquier contenido dentro de un AdaptiveGroup. |
AdaptiveSubgroup
Novedad de la actualización de aniversario: los subgrupos son columnas verticales que pueden contener texto e imágenes.
| Property | Type | Required | Description |
|---|---|---|---|
| Children | IList<IAdaptiveSubgroupChild> | false | AdaptiveText y AdaptiveImage son elementos secundarios válidos de subgrupos. |
| HintWeight | int? | false | Controlar el ancho de esta columna de subgrupo especificando el peso, en relación con los otros subgrupos. |
| HintTextStacking | AdaptiveSubgroupTextStacking | false | Controlar la alineación vertical del contenido de este subgrupo. |
IAdaptiveSubgroupChild
Interfaz de marcador para los hijos del subgrupo.
| Implementations |
|---|
| AdaptiveText |
| AdaptiveImage |
AdaptiveSubgroupTextStacking
TextStacking especifica la alineación vertical del contenido.
| Value | Meaning |
|---|---|
| Default | Valor predeterminado. El representador selecciona automáticamente la alineación vertical predeterminada. |
| Top | Alinear verticalmente a la parte superior. |
| Center | Alinear verticalmente con el centro. |
| Bottom | Alinear verticalmente a la parte inferior. |
AdaptiveProgressBar
Novedades de Creators Update: una barra de progreso. Solo se admite en notificaciones del sistema en escritorio, compilación 15063 o posterior.
| Property | Type | Required | Description |
|---|---|---|---|
| Title | cadena o BindableString | false | Obtiene o establece una cadena de título opcional. Admite la vinculación de datos. |
| Value | double o AdaptiveProgressBarValue o BindableProgressBarValue | false | Obtiene o establece el valor de la barra de progreso. Admite la vinculación de datos. El valor predeterminado es 0. |
| ValueStringOverride | cadena o BindableString | false | Obtiene o establece una cadena opcional que se va a mostrar en lugar de la cadena de porcentaje predeterminada. Si no se proporciona esto, se mostrará algo parecido a "70%". |
| Status | cadena o BindableString | true | Obtiene o establece una cadena de estado (obligatorio), que se muestra debajo de la barra de progreso de la izquierda. Esta cadena debe reflejar el estado de la operación, como "Descargar..." o "Instalar..." |
AdaptiveProgressBarValue
Clase que representa el valor de la barra de progreso.
| Property | Type | Required | Description |
|---|---|---|---|
| Value | double | 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 está indeterminada. Si esto es verdadero, se omitirá el Valor. |
BindableProgressBarValue
Valor enlazable de la barra de progreso.
| Property | Type | Required | Description |
|---|---|---|---|
| BindingName | string | true | Obtiene o establece el nombre que corresponde a su valor de datos de enlace. |
ToastGenericAppLogo
Logotipo que se va a mostrar en lugar del logotipo de la aplicación.
| Property | Type | Required | Description |
|---|---|---|---|
| Source | string | true | Dirección URL de la imagen. se admiten ms-appx, ms-appdata y http. Las imágenes HTTP deben tener un tamaño de 200 KB o menos. |
| HintCrop | ToastGenericAppLogoCrop | false | Especifique cómo desea que se recorte la imagen. |
| AlternateText | string | false | Texto alternativo que describe la imagen, que se usa con fines de accesibilidad. |
| AddImageQuery | bool? | 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 emergente. 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 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 | Meaning |
|---|---|
| Default | El recorte se rige por el comportamiento predeterminado del renderizador. |
| None | La imagen no se recorta, se muestra cuadrada. |
| Circle | La imagen se recorta en un círculo. |
ToastGenericHeroImage
Una imagen destacada de "héroe" que se muestra en el aviso emergente y en el Centro de actividades.
| Property | Type | Required | Description |
|---|---|---|---|
| Source | string | true | Dirección URL de la imagen. se admiten 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 | bool? | 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 emergente. 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 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 emergente.
| Property | Type | Required | Description |
|---|---|---|---|
| Text | string | true | Texto que se va a mostrar. |
| Language | string | false | La configuración regional de destino de la carga visual, como cuando se usan recursos localizados, se especifica mediante etiquetas de idioma BCP-47 como "en-US" o "fr-FR". Si no se proporciona, la configuración regional del sistema se usará en su lugar. |
IToastActions
Interfaz de marcador para acciones/entradas de notificaciones.
| Implementations |
|---|
| ToastActionsCustom |
| ToastActionsSnoozeAndDismiss |
ToastActionsCustom
Implementa IToastActions
Cree sus propias acciones y entradas personalizadas mediante controles como botones, cuadros de texto y entradas de selección.
| Property | Type | Required | Description |
|---|---|---|---|
| Inputs | IList<> IToastInput | false | Entradas como cuadros de texto y entradas de selección. Solo se permiten 5 entradas como máximo. |
| Buttons | 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: elementos de menú contextual personalizados, proporcionando 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 las entradas del sistema.
| Implementations |
|---|
| ToastTextBox |
| ToastSelectionBox |
ToastTextBox
Implementa IToastInput
Control de cuadro de texto en el que el usuario puede escribir texto.
| Property | Type | Required | Description |
|---|---|---|---|
| Id | string | true | El identificador es necesario y se usa para asignar el texto introducido por el usuario en un par clave-valor de id/value que la aplicación consume más adelante. |
| Title | 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 va a mostrar en el cuadro de texto cuando el usuario aún no ha escrito ningún texto. |
| DefaultInput | string | false | Texto inicial que se va a colocar en el cuadro de texto. Deje este valor NULL para un cuadro de texto en blanco. |
ToastSelectionBox
Implementa IToastInput
Un control de cuadro de selección, que permite a los usuarios elegir entre una lista desplegable de opciones.
| Property | Type | Required | Description |
|---|---|---|---|
| Id | string | true | El identificador es obligatorio. Si el usuario selecciona este elemento, el identificador se pasará al código de tu aplicación, representando la opción que eligieron. |
| Content | string | true | El contenido es necesario y es una cadena que se muestra en el elemento de selección. |
ToastSelectionBoxItem
Un elemento de cuadro de selección (un elemento que el usuario puede seleccionar en la lista desplegable).
| Property | Type | Required | Description |
|---|---|---|---|
| Id | string | true | El identificador es necesario y se usa para asignar el texto introducido por el usuario en un par clave-valor de id/value que la aplicación consume más adelante. |
| Title | 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 Id del objeto ToastSelectionBoxItem. Si no proporciona esto, la selección predeterminada estará vacía (el usuario no ve nada). |
| Items | IList<ToastSelectionBoxItem> | false | Los elementos entre los que el usuario puede seleccionar en esta caja de selección. Solo se pueden agregar 5 elementos. |
IToastButton
Interfaz de marcador para botones de notificación emergente.
| Implementations |
|---|
| ToastButton |
| ToastButtonSnooze |
| ToastButtonDismiss |
ToastButton
Implementa IToastButton
Botón en el que el usuario puede hacer clic.
| Property | Type | Required | Description |
|---|---|---|---|
| Content | string | true | Required. Texto que se va a mostrar en el botón. |
| Arguments | string | true | Required. Cadena definida por la aplicación de argumentos que recibirá la aplicación 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 en Creators Update: obtén o establece opciones adicionales relacionadas con la activación del botón de notificación. |
ToastActivationType
Decide el tipo de activación que se usará cuando el usuario interactúe con una acción específica.
| Value | Meaning |
|---|---|
| Foreground | Valor predeterminado. Se inicia la aplicación en primer plano. |
| Background | Se desencadena la tarea en segundo plano correspondiente (suponiendo que configure todo) y puede ejecutar código en segundo plano (como enviar el mensaje de respuesta rápida del usuario) sin interrumpir al usuario. |
| Protocol | Inicie otra aplicación mediante la activación del protocolo. |
ToastActivationOptions
Novedad de Creators Update: opciones adicionales relacionadas con la activación.
| Property | Type | Required | Description |
|---|---|---|---|
| AfterActivationBehavior | ToastAfterActivationBehavior | false | Novedad de Fall Creators Update: obtiene o establece el comportamiento que el sistema debe usar cuando el usuario realice esta acción. Esto solo funciona en escritorio, para ToastButton y ToastContextMenuItem. |
| ProtocolActivationTargetApplicationPfn | string | false | Si usa ToastActivationType.Protocol, opcionalmente puede especificar el PFN de destino para que, independientemente de si varias aplicaciones están registradas para controlar el mismo URI de protocolo, la aplicación deseada siempre se iniciará. |
ToastAfterActivationBehavior
Especifica el comportamiento que el toast debe seguir cuando el usuario realiza una acción sobre él.
| Value | Meaning |
|---|---|
| Default | Comportamiento 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 de la notificación del sistema, la notificación permanecerá presente, en un estado visual de "actualización pendiente". Debe actualizar inmediatamente la notificación emergente desde una tarea en segundo plano para que el usuario no vea este estado visual de "actualización pendiente" durante demasiado tiempo. |
ToastButtonSnooze
Implementa IToastButton
Un botón de posponer controlado por el sistema que controla automáticamente la posposición de la notificación.
| Property | Type | Required | Description |
|---|---|---|---|
| CustomContent | string | false | Texto personalizado opcional para el botón que reemplaza al texto predeterminado localizado "Posponer". |
ToastButtonDismiss
Implementa IToastButton
Un botón de descarte controlado por el sistema que descarta la notificación cuando se hace clic en él.
| Property | Type | Required | Description |
|---|---|---|---|
| CustomContent | string | false | Texto personalizado opcional que se muestra en el botón y que reemplaza el texto predeterminado localizado de "Descartar." |
ToastActionsSnoozeAndDismiss
Implementa IToastActions
Construye automáticamente un cuadro de selección para intervalos de posponer y botones de posponer y descartar, todo localizado automáticamente y la lógica de posponer es gestionada automáticamente por el sistema.
| Property | Type | Required | Description |
|---|---|---|---|
| ContextMenuItems | IList<ToastContextMenuItem> | false | Novedad de la actualización de aniversario: elementos de menú contextual personalizados, proporcionando 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.
| Property | Type | Required | Description |
|---|---|---|---|
| Content | string | true | Required. Texto que se va a mostrar. |
| Arguments | string | true | Required. Cadena definida por la aplicación de argumentos que la aplicación puede recuperar más adelante una vez que se activa cuando el usuario hace clic en el elemento de menú. |
| ActivationType | ToastActivationType | false | Controla qué tipo de activación usará este elemento de menú cuando se haga clic en él. El valor predeterminado es Primer plano. |
| ActivationOptions | ToastActivationOptions | false | Novedad en Creators Update: opciones adicionales relacionadas con la activación del elemento de menú contextual de notificaciones. |
ToastAudio
Especifica el audio que se reproducirá cuando se reciba la notificación.
| Property | Type | Required | Description |
|---|---|---|---|
| Src | uri | false | Archivo multimedia que se va a reproducir en lugar del sonido predeterminado. Solo se admiten ms-appx y ms-resource. No se admite todo lo demás (ms-appdata, http, C:, etc.). |
| Loop | boolean | false | Establézcalo en true si el sonido debe repetirse siempre que se muestre la notificación emergente; false para reproducir solo una vez (valor predeterminado). |
| Silent | boolean | false | True para silenciar el sonido; false para permitir que el sonido de notificación del sistema se reproduzca (valor predeterminado). |
ToastHeader
Novedad de Creators Update: un encabezado personalizado que agrupa varias notificaciones en el Centro de actividades.
| Property | Type | Required | Description |
|---|---|---|---|
| Id | string | true | Identificador creado por el desarrollador que identifica de forma única este encabezado. Si dos notificaciones tienen el mismo identificador de encabezado, se mostrarán debajo del mismo encabezado en el Centro de actividades. |
| Title | string | true | Título del encabezado. |
| Arguments | string | true | Obtiene o establece una cadena definida por el desarrollador de argumentos 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 ella. El valor predeterminado es Primer plano. Tenga en cuenta que solo se admiten Foreground y Protocol. |
| ActivationOptions | ToastActivationOptions | false | Obtiene o establece opciones adicionales relacionadas con la activación o interacción del encabezado de la notificación. |