다음을 통해 공유


Image 요소

이미지를 나타냅니다.

사용량

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

특성

attribute Type 필수 설명
ID
xs:positiveInteger union xs:string
No
고유한 리소스 ID입니다.

(xs:positiveInteger 및 xs:string의 합체)
2에서 59999 사이의 정수 값(포함) 또는 0x2 및 0xea5f 16진수(포함)입니다.
최대 길이는 선택적 선행 0을 포함하여 10자입니다.
MinDPI
xs:positiveInteger
No
(xs:positiveInteger)
최소값이 96인 모든 숫자 시퀀스입니다.
MinDPI를 생략하면 기본값은 96입니다.
원본
xs:anyURI
No
(xs:anyURI)
URI를 나타내는 모든 문자 시퀀스입니다. URI 값은 BMP 형식의 이미지 리소스에 대한 절대 또는 상대 경로(리본 태그 파일)입니다.
기호
xs:string
No
이미지의 리소스 기호입니다.

(xs:string)
문자 또는 밑줄로 구성된 문자열과 최대 100자까지의 문자, 숫자 또는 밑줄 시퀀스입니다.

자식 요소

요소 Description
Image.Source
최대 한 번 발생할 수 있습니다.

부모 요소

요소
Command.LargeHighContrastImages
Command.LargeImages
Command.SmallHighContrastImages
Command.SmallImages

설명

선택 사항입니다.

Command.SmallImages, Command.SmallHighContrastImages, Command.LargeImages 또는 Command.LargeHighContrastImages 요소에 대해 하나 이상 발생할 수 있습니다.

이미지 요소 집합을 통해 특정 dpi(인치당 화면 점) 설정을 지원하도록 설계된 이미지 리소스 컬렉션이 Ribbon 프레임워크에 제공되면 프레임워크는 현재 화면 dpi 설정과 일치하는 MinDPI 특성 값이 있는 Image를 사용합니다.

현재 화면 dpi 설정과 일치하는 MinDPI 값으로 선언된 Image 요소가 없는 경우 프레임워크는 현재 화면 dpi 설정보다 가장 가까운 MinDPI 값이 있는 이미지를 선택하고 이미지 리소스를 확장합니다. 그렇지 않으면 현재 화면 dpi 설정보다 작은 MinDPI 특성 값으로 선언된 Image 요소가 없는 경우 프레임워크는 현재 화면 dpi 설정보다 가장 가까운 MinDPI 값을 선택하고 이미지 리소스를 축소합니다.

예제

다음 코드 예제에서는 이미지 요소 집합을 통해 4개의 특정 화면 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
  • 비워 둘 수 있음: 아니요

추가 정보

리본 이미지 리소스 지정