Elemento Image

Representa uma imagem.

Uso

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

Atributos

Atributo	Tipo	Obrigatório	Descrição
Id	xs:positiveInteger union xs:string	Não	A ID do recurso exclusivo. (A união de xs:positiveInteger e xs:string) Um valor inteiro entre 2 e 59999, inclusivo ou 0x2 e 0xea5f em hexadecimal, inclusive. O comprimento máximo é de 10 caracteres, incluindo zeros à esquerda opcionais.
MinDPI	xs:positiveInteger	Não	(xs:positiveInteger) Qualquer sequência de dígitos com um valor mínimo de 96. Se MinDPI for omitido, o valor padrão será 96.
Origem	xs:anyURI	Não	(xs:anyURI) Qualquer sequência de caracteres que representa um URI. O valor do URI é um caminho absoluto ou relativo (ao arquivo de marcação da Faixa de Opções) para um recurso de imagem do tipo BMP.
Símbolo	xs:string	Não	O símbolo de recurso para a imagem. (xs:string) Uma cadeia de caracteres composta por uma letra ou sublinhado seguido por qualquer sequência de letras, dígitos ou sublinhados até um máximo de 100 caracteres.

Elementos filho

Elemento	Descrição
Image.Source	Pode ocorrer no máximo uma vez

Elementos pai

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

Comentários

Opcional.

Pode ocorrer uma ou mais vezes para cada elemento Command.SmallImages, Command.SmallHighContrastImages, Command.LargeImages ou Command.LargeHighContrastImages .

Quando uma coleção de recursos de imagem que são projetados para dar suporte a pontos de tela específicos por polegada (dpi) é fornecida à estrutura da Faixa de Opções por meio de um conjunto de elementos Image , a estrutura usa a imagem com um valor de atributo MinDPI que corresponde à configuração de dpi de tela atual.

Se nenhum elemento Image for declarado com um valor MinDPI que corresponda à configuração de dpi de tela atual, a estrutura escolherá a Imagem que tem o valor minDPI mais próximo menor do que a configuração de dpi de tela atual e dimensiona o recurso de imagem para cima. Caso contrário, se nenhum elemento Image for declarado com um valor de atributo MinDPI menor que a configuração de dpi de tela atual, a estrutura escolherá o valor minDPI mais próximo maior que a configuração de dpi de tela atual e reduzirá o recurso de imagem.

Exemplos

O exemplo de código a seguir mostra a marcação necessária para declarar, por meio de um conjunto de elementos Image , uma coleção de recursos de imagem projetados para dar suporte a quatro configurações de dpi de tela específicas.

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

Informações do elemento

• Sistema mínimo com suporte: Windows 7
• Pode estar vazio: Não

Confira também

Especificando recursos de imagem da faixa de opções