Esquema de contenido de icono

Nota:

Los iconos dinámicos son una característica de Windows 10 que no se admite en versiones posteriores de Windows. En el caso de las nuevas aplicaciones, se recomienda seguir las instrucciones actuales para los iconos de la aplicación.

A continuación, se describen todas las propiedades y elementos del contenido del mosaico.

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

• TileContent
  • TileVisual
    • TileBinding
      • TileBindingContentAdaptive
      • TileBindingContentIconic
      • TileBindingContentContact
      • TileBindingContentPeople
      • TileBindingContentPhotos

TileContent

TileContent es el objeto de nivel superior que describe el contenido de una notificación de mosaico, incluidos los objetos visuales.

Propiedad	Type	Obligatorio	Descripción
Objeto visual	ToastVisual	true	Describe la parte visual de la notificación del mosaico.

TileVisual

La parte visual de los mosaicos contiene las especificaciones visuales de todos los tamaños de mosaico y propiedades que más relación tienen con objetos visuales.

Propiedad	Type	Obligatorio	Descripción
TileSmall	TileBinding	false	Permite proporcionar un enlace pequeño opcional para especificar contenido para el tamaño pequeño del mosaico.
TileMedium	TileBinding	false	Permite proporcionar un enlace medio opcional para especificar contenido para el tamaño medio del mosaico.
TileWide	TileBinding	false	Permite proporcionar un enlace ancho opcional para especificar contenido para el tamaño ancho del mosaico.
TileLarge	TileBinding	false	Permite proporcionar un enlace grande opcional para especificar contenido para el tamaño grande del mosaico.
Personalización de marca	TileBranding	false	Formulario que el mosaico debe usar para mostrar la marca de la aplicación. De forma predeterminada, hereda la personalización de marca del mosaico predeterminado.
DisplayName	string	false	Cadena opcional para invalidar el nombre para mostrar del mosaico al mostrar esta notificación.
Argumentos	string	false	Novedad de la actualización de aniversario: datos definidos por la aplicación que se pasan a su aplicación a través de la propiedad TileActivatedInfo en LaunchActivatedEventArgs cuando el usuario inicia la aplicación desde el icono dinámico. Esto le permite saber qué notificaciones de mosaico vio el usuario al pulsar el icono dinámico. En los dispositivos sin la actualización de aniversario, esto simplemente se omitirá.
LockDetailedStatus1	string	false	Si especifica esto, también debe proporcionar un enlace TileWide. Esta es la primera línea de texto que se mostrará en la pantalla de bloqueo si el usuario ha seleccionado el mosaico como aplicación de estado detallada.
LockDetailedStatus2	string	false	Si especifica esto, también debe proporcionar un enlace TileWide. Esta es la segunda línea de texto que se mostrará en la pantalla de bloqueo si el usuario ha seleccionado el mosaico como aplicación de estado detallada.
LockDetailedStatus3	string	false	Si especifica esto, también debe proporcionar un enlace TileWide. Esta es la tercera línea de texto que se mostrará en la pantalla de bloqueo si el usuario ha seleccionado el mosaico como aplicación de estado detallada.
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.

TileBinding

El objeto de enlace contiene el contenido visual de un tamaño de mosaico específico.

Propiedad	Type	Obligatorio	Descripción
Contenido	ITileBindingContent	false	Contenido visual que se va a mostrar en el mosaico. Uno de los elementos TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContentPeople, or TileBindingContentPhotos.
Personalización de marca	TileBranding	false	Formulario que el mosaico debe usar para mostrar la marca de la aplicación. De forma predeterminada, hereda la personalización de marca del mosaico predeterminado.
DisplayName	string	false	Cadena opcional para invalidar el nombre para mostrar del mosaico para este tamaño de mosaico.
Argumentos	string	false	Novedad de la actualización de aniversario: datos definidos por la aplicación que se pasan a su aplicación a través de la propiedad TileActivatedInfo en LaunchActivatedEventArgs cuando el usuario inicia la aplicación desde el icono dinámico. Esto le permite saber qué notificaciones de mosaico vio el usuario al pulsar el icono dinámico. En los dispositivos sin la actualización de aniversario, esto simplemente se omitirá.
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.

ITileBindingContent

Interfaz de marcador para el contenido de enlace del mosaico. Estas opciones le permiten elegir lo que desea especificar en los objetos visuales del mosaico en el valor Adaptive o en una de las plantillas especiales.

Implementaciones
TileBindingContentAdaptive
TileBindingContentIconic
TileBindingContentContact
TileBindingContentPeople
TileBindingContentPhotos

TileBindingContentAdaptive

Se admite en todos los tamaños. Esta es la forma recomendada de especificar el contenido del mosaico. Las plantillas de mosaico adaptables son nuevas en Windows 10 y puede crear una amplia variedad de mosaicos personalizados a través de la adaptación.

Propiedad	Type	Obligatorio	Descripción
Children	IList<ITileBindingContentAdaptiveChild>	false	Elementos visuales insertados. Se pueden agregar los objetos AdaptiveText, AdaptiveImage y AdaptiveGroup. Los elementos secundarios se muestran de forma StackPanel vertical.
BackgroundImage	TileBackgroundImage	false	Imagen de fondo opcional que se muestra detrás de todo el contenido del mosaico (sangría completa).
PeekImage	TilePeekImage	false	Imagen de inspección opcional que se anima desde la parte superior del mosaico.
TextStacking	TileTextStacking	false	Controla el apilamiento del texto (alineación vertical) del contenido secundario en su conjunto.

AdaptiveText

Elemento de texto adaptable.

Propiedad	Type	Obligatorio	Descripción
Texto	string	false	Texto que se mostrará.
HintStyle	AdaptiveTextStyle	false	El estilo controla el tamaño de fuente, el peso y la opacidad del texto.
HintWrap	¿Valor booleano?	false	Establézcalo en "true" para habilitar el ajuste de texto. El valor predeterminado es "false".
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.
HintAlign	AdaptiveTextAlign	false	Alineación horizontal del texto.
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.

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.
HintCrop	AdaptiveImageCrop	false	Permite controlar 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.
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 mosaico. 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

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

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.

Valor	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.

TileBackgroundImage

Imagen de fondo que se muestra con sangría completa en el mosaico.

Propiedad	Type	Obligatorio	Descripción
Origen	string	true	Dirección URL de la imagen. Se admiten ms-appx, ms-appdata y http(s). Las imágenes HTTP deben tener un tamaño de 200 KB o menos.
HintOverlay	¿Valor int?	false	Superposición negra en la imagen de fondo. Este valor controla la opacidad de la superposición negra; el valor 0 indica que no hay superposición y el valor 100 indica una superposición completamente negra. El predeterminado es 20.
HintCrop	TileBackgroundImageCrop	false	Novedad de 1511: permite especificar cómo quiere recortar la imagen. En las versiones anteriores a 1511, esta opción se omitirá y se mostrará la imagen de fondo sin recortar.
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 mosaico. 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".

TileBackgroundImageCrop

Controla el recorte de la imagen de fondo.

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.

TilePeekImage

Imagen de inspección que se anima desde la parte superior del mosaico.

Propiedad	Type	Obligatorio	Descripción
Origen	string	true	Dirección URL de la imagen. Se admiten ms-appx, ms-appdata y http(s). Las imágenes HTTP deben tener un tamaño de 200 KB o menos.
HintOverlay	¿Valor int?	false	Novedad en 1511: superposición negra en la imagen de inspección. Este valor controla la opacidad de la superposición negra; el valor 0 indica que no hay superposición y el valor 100 indica una superposición completamente negra. El predeterminado es 20. En versiones anteriores, este valor se omitirá y se mostrará la imagen de inspección con un valor 0 de superposición.
HintCrop	TilePeekImageCrop	false	Novedad de 1511: permite especificar cómo quiere recortar la imagen. En las versiones anteriores a la versión 1511, esto se omitirá y se mostrará la imagen de inspección sin recortar.
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 mosaico. 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".

TilePeekImageCrop

Controla el recorte de la imagen de inspecció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.

TileTextStacking

El apilamiento del texto especifica la alineación vertical del contenido.

Valor	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.

TileBindingContentIconic

Compatible en los tamaños pequeño y mediano. Habilita una plantilla de mosaico icónica, donde puede visualizar un icono y una insignia juntos en el mosaico, emulando el verdadero estilo clásico de Windows Phone. El número situado junto al icono se obtiene a través de una notificación de insignia independiente.

Propiedad	Type	Obligatorio	Descripción
Icono	TileBasicImage	true	Como mínimo, para admitir mosaicos de escritorio y móvil pequeños y medianos, debe proporcionar una imagen de relación de aspecto cuadrado con una resolución de 200x200, en formato PNG, con transparencia y ningún color distinto del blanco. Para obtener más información, consulte Especificaciones de plantilla.

TileBindingContentContact

Solo móvil. Compatible con tamaños pequeño, mediano y ancho.

Propiedad	Type	Obligatorio	Descripción
Imagen	TileBasicImage	true	Imagen que se va a mostrar.
Texto	TileBasicText	false	Línea de texto que se muestra. No se muestra en un mosaico pequeño.

TileBindingContentPeople

Novedad en 1511: compatible con los tamaños mediano, ancho y grande (escritorio y móvil). Anteriormente era solo compatible para móvil y para tamaños medio y ancho.

Propiedad	Type	Obligatorio	Descripción
Imágenes	IList<TileBasicImage>	true	Imágenes que se desplazarán como círculos.

TileBindingContentPhotos

Se anima mediante una presentación de fotos. Se admite en todos los tamaños.

Propiedad	Type	Obligatorio	Descripción
Imágenes	IList<TileBasicImage>	true	Se pueden proporcionar hasta 12 imágenes (el móvil solo mostrará hasta 9) que se usarán para la presentación. Al agregar más de 12, se producirá una excepción.

TileBasicImage

Imagen que se usará en varias plantillas especiales.

Propiedad	Type	Obligatorio	Descripción
Origen	string	true	Dirección URL de la imagen. Se admiten ms-appx, ms-appdata y http(s). 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 mosaico. 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".

TileBasicText

Elemento de texto básico que se usa en varias plantillas especiales.

Propiedad	Type	Obligatorio	Descripción
Texto	string	false	Texto que se mostrará.
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.

Temas relacionados

• Enviar una notificación de icono local
• Biblioteca de notificaciones en GitHub