Compartir a través de


imagen (esquema XML del sistema)

Especifica una imagen usada en la plantilla del sistema.

Jerarquía de elemento

<Brindis>
<visual>
<binding>
<Imagen>

Sintaxis

<image id             = integer
       src            = string
       alt?           = string
       addImageQuery? = boolean 
       placement? = "appLogoOverride" | "hero"
       hint-crop? = "circle" />

Clave

? opcional (cero o uno)

Atributos y elementos

Atributos

Atributo Descripción Tipo de datos Obligatorio Valor predeterminado
addImageQuery

Establezca en "true" para permitir que Windows anexe una cadena de consulta al URI de imagen proporcionado 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 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"

boolean No false
alt

Descripción de la imagen, para los usuarios de tecnologías de asistencia.

string No None
id

Elemento image de la plantilla del sistema para el que esta imagen está pensada. Si una plantilla solo tiene una imagen, este valor es 1. El número de posiciones de imagen disponibles se basa en la definición de plantilla.

integer None
src

El URI del origen de la imagen, mediante uno de estos controladores de protocolo:

  • http:// o https://

    Imagen basada en web.

  • ms-appx:///

    Imagen incluida en el paquete de la aplicación.

  • ms-appdata:///local/

    Imagen guardada en el almacenamiento local.

  • Archivo:///

    Imagen local. (Solo se admite para aplicaciones de escritorio. Las aplicaciones para UWP no pueden usar este protocolo).

string None
placement

Ubicación de la imagen.

  • "appLogoOverride": la imagen reemplaza el logotipo de la aplicación en la notificación del sistema.
  • "hero": la imagen se muestra como una imagen prominente.

Para obtener más información, consulte Contenido del sistema.

string No None
recorte de sugerencias

Recorte de la imagen.

  • "círculo": la imagen se recorta en un círculo.
  • Sin especificar: la imagen no se recorta y se muestra como un cuadrado.

Para obtener más información, consulte Contenido del sistema.

string No None

 

Elementos secundarios

Ninguno.

Elementos primarios

Elemento primario Descripción
binding

Especifica la plantilla del sistema. Tenga en cuenta que solo se puede incluir un elemento de enlace en una notificación del sistema.

Consulte también