RibbonDialogLauncher.ImageName 속성
RibbonDialogLauncher가 빠른 실행 도구 모음에 추가될 때 이 아이콘에 이미지를 할당하는 데 사용되는 식별자를 가져오거나 설정합니다.
네임스페이스: 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
RibbonDialogLauncher 가 빠른 실행 도구 모음에 추가될 때 이 아이콘에 이미지를 할당하는 데 사용되는 식별자입니다.
설명
이 속성은 특정 조건에서만 런타임에 설정할 수 있습니다. 자세한 내용은 리본 개체 모델 개요을 참조하십시오.
RibbonDialogLauncher가 리본 메뉴의 그룹에 표시될 경우 ImageName 속성은 시각적으로 아무런 영향을 주지 않습니다. 그러나 사용자가 빠른 실행 도구 모음에 RibbonDialogLauncher를 추가하면 Image 또는 OfficeImageId 속성이 설정되어 있지 않은 한 이 속성은 표시된 이미지의 동작을 제어합니다.
ImageName 속성은 컨트롤에 표시되는 이미지를 식별합니다. Office 응용 프로그램은 성능 향상을 위해 솔루션에서 이 이미지를 한 번만 검색합니다. 이 속성은 LoadImage 이벤트 동안 식별되는 이미지가 로드되기 때문에 디자인 타임에만 설정할 수 있습니다. 리본 메뉴가 표시될 때 이미지 이름 당 한 번만 LoadImage가 발생합니다. 그런 뒤에는 이 속성을 사용하여 컨트롤 이미지를 변경할 수 없습니다.
이미지를 로드하려면 LoadImage 이벤트 처리기에 코드를 추가합니다. RibbonLoadImageEventArgs의 ImageName 속성을 확인하고 RibbonLoadImageEventArgs 개체의 Image 속성을 로드할 이미지로 설정합니다.
Image 속성이나 OfficeImageId 속성이 설정되어 있으면 이 속성은 무시됩니다. Office 응용 프로그램에서는 리본 메뉴가 처음 표시될 때만 솔루션에서 이미지를 검색하므로 ImageName 속성으로 식별된 이미지는 Image 속성으로 식별된 이미지보다 약간 더 빠르게 로드할 수 있습니다.
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.
참고 항목
참조
Microsoft.Office.Tools.Ribbon 네임스페이스