다음을 통해 공유


RibbonSplitButton.ImageName 속성

E:Microsoft.Office.Tools.Ribbon.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
E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage 이벤트 처리기에서 컨트롤의 이미지를 식별하는 데 사용할 수 있는 문자열입니다.

설명

ImageName 속성은 컨트롤에 표시되는 이미지를 식별합니다. Office 응용 프로그램은 성능 향상을 위해 솔루션에서 이 이미지를 한 번만 검색합니다. 이 속성은 LoadImage 이벤트 동안 식별되는 이미지가 로드되기 때문에 디자인 타임에만 설정할 수 있습니다. 리본 메뉴가 표시될 때 이미지 이름 당 한 번만 LoadImage가 발생합니다. 그런 뒤에는 이 속성을 사용하여 컨트롤 이미지를 변경할 수 없습니다.

이미지를 로드하려면 LoadImage 이벤트 처리기에 코드를 추가합니다. RibbonLoadImageEventArgsImageName 속성을 확인하고 RibbonLoadImageEventArgs 개체의 Image 속성을 로드할 이미지로 설정합니다.

Image 속성이나 OfficeImageId 속성이 설정되어 있으면 이 속성은 무시됩니다. Office 응용 프로그램에서는 리본 메뉴가 처음 표시될 때만 솔루션에서 이미지를 검색하므로 ImageName 속성으로 식별된 이미지는 Image 속성으로 식별된 이미지보다 약간 더 빠르게 로드할 수 있습니다.

.NET Framework 보안

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

RibbonSplitButton 인터페이스

Microsoft.Office.Tools.Ribbon 네임스페이스

기타 리소스

리본 개체 모델 개요