RibbonDropDown.ImageName 속성
LoadImage 이벤트 처리기에서 컨트롤의 이미지를 식별하는 데 사용할 수 있는 이름을 가져오거나 설정합니다.
네임스페이스: Microsoft.Office.Tools.Ribbon
어셈블리: Microsoft.Office.Tools.Common(Microsoft.Office.Tools.Common.dll)
구문
‘선언
Property ImageName As String
Get
Set
string ImageName { get; set; }
속성 값
형식: System.String
LoadImage 이벤트 처리기에서 컨트롤의 이미지를 식별하는 데 사용할 수 있는 문자열입니다.
설명
ImageName 속성은 컨트롤에 표시되는 이미지를 식별합니다. Office 응용 프로그램은 성능 향상을 위해 솔루션에서 이 이미지를 한 번만 검색합니다. 이 속성은 LoadImage 이벤트 동안 식별되는 이미지가 로드되기 때문에 디자인 타임에만 설정할 수 있습니다. 리본 메뉴가 표시될 때 이미지 이름 당 한 번만 LoadImage가 발생합니다. 그런 뒤에는 이 속성을 사용하여 컨트롤 이미지를 변경할 수 없습니다. 이 속성의 설정에 대한 자세한 내용은 리본 개체 모델 개요를 참조하십시오.
이미지를 로드하려면 LoadImage 이벤트 처리기에 코드를 추가합니다. RibbonLoadImageEventArgs의 ImageName 속성을 확인하고 RibbonLoadImageEventArgs 개체의 Image 속성을 로드할 이미지로 설정합니다.
Image 속성이나 OfficeImageId 속성이 설정되어 있으면 이 속성은 무시됩니다. Office 응용 프로그램에서는 리본 메뉴가 처음 표시될 때만 솔루션에서 이미지를 검색하므로 ImageName 속성으로 식별된 이미지는 Image 속성으로 식별된 이미지보다 약간 더 빠르게 로드할 수 있습니다.
컨트롤에 이미지를 표시하려면 ShowImage 속성이 true여야 합니다. 디자인 타임에 ImageName 속성을 설정할 때 Visual Studio은 ShowImage 속성을 true로 자동으로 설정됩니다. 런타임에 ImageName 속성을 설정할 경우에는 사용자가 직접 코드에서 ShowImage 속성을 true로 설정해야 합니다.
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.
참고 항목
참조
Microsoft.Office.Tools.Ribbon 네임스페이스