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.
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.
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.
Valor
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.
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
Identificador 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.
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.
Texto de atribución opcional que se mostrará en la parte inferior de la notificación del sistema.
BaseUri
Identificador 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.
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.
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.
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.
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.
Valor
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.
Valor
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.
Left
Permite alinear horizontalmente el texto a la izquierda.
de las instalaciones
Permite alinear horizontalmente el texto en el centro.
Right
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.
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".
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.
Valor
Significado
Valor predeterminado
Valor predeterminado. El representador determina el comportamiento del recorte.
None
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.
Valor
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).
Left
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.
Right
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.
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 %".
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.
ToastGenericAppLogo
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.
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.
Valor
Significado
Valor predeterminado
El recorte usa el comportamiento predeterminado del representador.
None
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.
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).
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.
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.
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.
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.
Valor
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.
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.
Valor
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.
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.
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ú.
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.
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.
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios de Windows developer
Windows developer es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:
Las tarjetas adaptables son miniprogramas de la interfaz de usuario (IU) válidos en la plataforma, creados en JSON, que las aplicaciones y los servicios pueden intercambiarlas de forma abierta. Cuando llega a una aplicación específica, el JSON se transforma en la interfaz de usuario nativa que se adapta automáticamente a su entorno. Permite diseñar e integrar la interfaz de usuario de poco peso para todas las plataformas y entornos principales. En este módulo, aprenderá a crear mensajes atractivos con tarje