Elemento Image

Articolo
06/13/2023

Rappresenta un'immagine.

Utilizzo

<Image
  Source = "xs:anyURI"
  MinDPI = "xs:positiveInteger"
  Symbol = "xs:string"
  Id = "xs:positiveInteger union xs:string">
  child elements
</Image>

Attributi

Attributo	Type	Obbligatoria	Description
Id	xs:positiveInteger union xs:string	No	ID risorsa univoco. (Unione di xs:positiveInteger e xs:string) Valore intero compreso tra 2 e 59999, inclusi o 0x2 e 0xea5f in esadecimale, inclusivo. La lunghezza massima è di 10 caratteri, inclusi gli zeri iniziali facoltativi.
MinDPI	xs:positiveInteger	No	(xs:positiveInteger) Qualsiasi sequenza di cifre con un valore minimo di 96. Se MinDPI viene omesso, il valore predefinito è 96.
Origine	xs:anyURI	No	(xs:anyURI) Qualsiasi sequenza di caratteri che rappresenta un URI. Il valore URI è un percorso assoluto o relativo (al file di markup della barra multifunzione) a una risorsa immagine di tipo BMP.
Simbolo	xs:string	No	Simbolo della risorsa per l'immagine. (xs:string) Stringa composta da una lettera o un carattere di sottolineatura seguito da qualsiasi sequenza di lettere, cifre o caratteri di sottolineatura fino a un massimo di 100 caratteri.

Elementi figlio

Elemento	Descrizione
Image.Source	Può verificarsi al massimo una volta

Elementi padre

Elemento
Command.LargeHighContrastImages
Command.LargeImages
Command.SmallHighContrastImages
Command.SmallImages

Commenti

Facoltativa.

Può verificarsi una o più volte per ogni elemento Command.SmallImages, Command.SmallHighContrastImages, Command.LargeImages o Command.LargeHighContrastImages .

Quando viene fornita una raccolta di risorse immagine progettate per supportare impostazioni specifiche di punti schermo per pollice (dpi) vengono fornite al framework della barra multifunzione tramite un set di elementi Image , il framework usa l'immagine con un valore di attributo MinDPI corrispondente all'impostazione dpi dello schermo corrente.

Se nessun elemento Image viene dichiarato con un valore MinDPI corrispondente all'impostazione dpi della schermata corrente, il framework seleziona l'immagine con il valore MinDPI più vicino rispetto all'impostazione dpi dello schermo corrente e ridimensiona la risorsa immagine verso l'alto. In caso contrario, se nessun elemento Image viene dichiarato con un valore di attributo MinDPI minore dell'impostazione dpi della schermata corrente, il framework seleziona il valore MinDPI più vicino rispetto all'impostazione dpi dello schermo corrente e ridimensiona la risorsa immagine verso il basso.

Esempio

Nell'esempio di codice seguente viene illustrato il markup necessario per dichiarare, tramite un set di elementi Image , una raccolta di risorse immagine progettate per supportare quattro impostazioni dpi specifiche dello schermo.

<Command Name="cmdSizeAndColor" Symbol="IDR_CMD_SIZEANDCOLOR">
  <Command.LabelTitle>
    <String Id="250">Size and Color</String>
  </Command.LabelTitle>
  <Command.LargeImages>
    <Image Id="251" MinDPI="96">res/sizeAndColor_96.bmp</Image>
    <Image Id="252" MinDPI="120">res/sizeAndColor_120.bmp</Image>
    <Image Id="253" MinDPI="144">res/sizeAndColor_144.bmp</Image>
    <Image Id="254" MinDPI="192">res/sizeAndColor_192.bmp</Image>
  </Command.LargeImages>
</Command>

Informazioni sull'elemento

Sistema minimo supportato: Windows 7
Può essere vuoto: No

Vedi anche

Specifica delle risorse dell'immagine della barra multifunzione

Condividi tramite