Image 要素
画像を表します。
使用
<Image
Source = "xs:anyURI"
MinDPI = "xs:positiveInteger"
Symbol = "xs:string"
Id = "xs:positiveInteger union xs:string">
child elements
</Image>
属性
| 属性 | Type | 必須 | 説明 |
|---|---|---|---|
|
Id |
xs:positiveInteger union xs:string |
いいえ |
一意のリソース ID。 最大長は、省略可能な先行ゼロを含む 10 文字です。 |
|
MinDPI |
xs:positiveInteger |
いいえ |
MinDPI を省略すると、既定値は 96 になります。 |
|
ソース |
xs:anyURI |
いいえ |
|
|
記号 |
xs:string |
いいえ |
イメージのリソース シンボル。 |
子要素
| 要素 | 説明 |
|---|---|
|
Image.Source |
最大で 1 回発生する可能性があります |
親要素
| 要素 |
|---|
|
Command.LargeHighContrastImages |
|
Command.LargeImages |
|
Command.SmallHighContrastImages |
|
Command.SmallImages |
注釈
省略可能。
Command.SmallImages、Command.SmallHighContrastImages、Command.LargeImages、または Command.LargeHighContrastImages 要素ごとに 1 回以上発生する可能性があります。
特定の画面ドット/インチ (dpi) 設定をサポートするように設計されたイメージ リソースのコレクションが、一連の Image 要素を介してリボン フレームワークに提供される場合、フレームワークは、現在の画面 dpi 設定に一致する MinDPI 属性値を持つ Image を使用します。
現在の画面 dpi 設定に一致する MinDPI 値を持つ Image 要素が宣言されていない場合、フレームワークは、現在の画面 dpi 設定よりも最も近い MinDPI 値が小さい Image を選択し、イメージ リソースをスケールアップします。 それ以外の場合、MinDPI 属性値が現在の画面 dpi 設定より小さい Image 要素が宣言されていない場合、フレームワークは現在の画面 dpi 設定より大きい最も近い MinDPI 値を選択し、イメージ リソースをスケールダウンします。
例
次のコード例は、4 つの特定の画面 dpi 設定をサポートするように設計されたイメージ リソースのコレクションである Image 要素のセットを通じて宣言するために必要なマークアップを示しています。
<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
- 空にできます: いいえ