RibbonButton.ImageName 속성

아티클
08/10/2011

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로 설정해야 합니다.

예제

다음 예제에서는 두 개의 단추에 대한 이미지를 캐시합니다.

이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

리본(비주얼 디자이너) 항목을 Visual Studio에 있는 Office 개발 도구를 사용하여 만든 프로젝트에 추가합니다.
그룹을 사용자 지정 탭에 추가합니다.
두 개의 단추를 그룹에 추가합니다.
두 개의 이미지를 프로젝트 리소스에 추가합니다. 자세한 내용은 방법: 리소스 추가 또는 제거을 참조하십시오.

그런 다음 생성된 리본 클래스에서 이 코드를 실행할 수 있습니다.

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal e As RibbonLoadImageEventArgs)
    Select Case e.ImageName
        Case "Button1Image"
            e.Image = My.Resources.Image1
        Case "Button2Image"
            e.Image = My.Resources.Image2
    End Select
End Sub

private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)
{
    switch (e.ImageName)
    {
        case "Button1Image":
            e.Image = Properties.Resources.Image1;
            break;
        case "Button2Image":
            e.Image = Properties.Resources.Image2;
            break;
    }
}