Esquema de contenido de icono

  • Artículo

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

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

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

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

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.

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.

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.

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.

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.

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.

TileTextStacking

El apilamiento del texto 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.

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.