通过

Image 元素

  • 项目

表示图像。

使用情况

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

特性

属性 类型 必选 说明
Id
xs：positiveInteger union xs：string
 否
 唯一的资源 ID。

(xs：positiveInteger 和 xs：string) 的并集
介于 2 和 59999 之间（含）或0x2的整数值，0xea5f十六进制（含）。
最大长度为 10 个字符，包括可选的前导零。
MinDPI
 xs:positiveInteger
 否
(xs：positiveInteger)
最小值为 96 的任何数字序列。
如果省略 MinDPI，则默认值为 96。
Source
 xs:anyURI
 否
(xs：anyURI)
表示 URI 的任何字符序列。 URI 值是功能区标记文件的绝对或相对 (，) 类型为 BMP 的图像资源的路径。
符号
 xs:string
 否
 图像的资源符号。

(xs：string)
由字母或下划线后跟任意字母、数字或下划线序列（最多 100 个字符）组成的字符串。

子元素

元素 说明
Image.Source
 最多可以发生一次

父元素

元素
Command.LargeHighContrastImages
Command.LargeImages
Command.SmallHighContrastImages
Command.SmallImages

备注

可选。

对于每个 Command.SmallImages、 Command.SmallHighContrastImages、 Command.LargeImages 或 Command.LargeHighContrastImages 元素，可能会发生一次或多次。

当通过一组 Image 元素向功能区框架提供设计为支持每英寸特定屏幕点数 (dpi) 设置的图像资源集合时，框架使用与当前屏幕 dpi 设置匹配的 MinDPI 属性值的图像。

如果没有使用与当前屏幕 dpi 设置匹配的 MinDPI 值声明 Image 元素，框架将选取最接近 MinDPI 值小于当前屏幕 dpi 设置的图像，并纵向扩展图像资源。 否则，如果没有使用小于当前屏幕 dpi 设置的 MinDPI 属性值声明 Image 元素，框架将选取大于当前屏幕 dpi 设置的最接近的 MinDPI 值，并缩小图像资源。

示例

下面的代码示例演示通过一组 Image 元素声明图像资源集合所需的标记，这些资源旨在支持四个特定的屏幕 dpi 设置。

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

元素信息

  • 支持的最低系统：Windows 7
  • 可以为空：否

另请参阅

指定功能区图像资源