RibbonEditBox.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 네임스페이스