RibbonButton.ImageName 속성 (2007 시스템)

아티클
08/22/2008

업데이트: 2007년 11월

LoadImage 이벤트 처리기에서 단추를 식별하는 데 사용할 수 있는 이름을 가져오거나 설정합니다.

네임스페이스: Microsoft.Office.Tools.Ribbon
어셈블리: Microsoft.Office.Tools.Common.v9.0(Microsoft.Office.Tools.Common.v9.0.dll)

구문

Public Property ImageName As String

Dim instance As RibbonButton
Dim value As String

value = instance.ImageName

instance.ImageName = value

public 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 Tools for Office에서는 ShowImage 속성을 자동으로 true로 설정합니다. 런타임에 ImageName 속성을 설정할 경우에는 사용자가 직접 코드에서 ShowImage 속성을 true로 설정해야 합니다.

예제

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

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

리본(비주얼 디자이너) 항목을 Visual Studio Tools for 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;
    }
}