RibbonSplitButton.ImageName 속성

정의

네임스페이스:

Microsoft.Office.Tools.Ribbon

어셈블리:

Microsoft.Office.Tools.Common.dll

E:Microsoft.Office.Tools.Ribbon.LoadImage 이벤트 처리기에서 컨트롤의 이미지를 식별하는 데 사용할 수 있는 이름을 가져오거나 설정합니다.

public:
 property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };

public string ImageName { get; set; }

member this.ImageName : string with get, set

Public Property ImageName As String

속성 값

String

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

설명

속성은 ImageName 컨트롤에 의해 표시되는 이미지를 식별합니다. Office 애플리케이션은 성능을 향상시키기 위해 솔루션에서 이 이미지를 한 번만 검색합니다. 이 속성은 이벤트 중에 식별되는 이미지가 로드되므로 디자인 타임에 LoadImage 만 설정할 수 있습니다. LoadImage 는 리본이 표시될 때 이미지 이름당 한 번만 발생합니다. 그 후에는 이 속성을 사용하여 컨트롤 이미지를 변경할 수 없습니다.

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

속성 또는 OfficeImageId 속성이 Image 설정된 경우 이 속성은 무시됩니다. 속성으로 ImageName 식별된 이미지는 속성으로 식별된 Image 이미지보다 약간 더 빠르게 로드할 수 있습니다. Office 애플리케이션은 리본 메뉴가 처음 표시될 때만 솔루션에서 이미지를 검색하기 때문입니다.