RibbonLoadImageEventArgs 인터페이스

LoadImage 이벤트에 대한 데이터를 제공합니다.

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

구문

‘선언
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs

[GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")]
public interface RibbonLoadImageEventArgs

RibbonLoadImageEventArgs 형식에서는 다음과 같은 멤버를 노출합니다.

속성

	이름	설명
	Image	로드할 리본 컨트롤의 이미지를 가져오거나 설정합니다.
	ImageName	리본 메뉴에 로드되는 이미지의 이름을 가져옵니다.

위쪽

설명

컨트롤의 ImageName 속성으로 식별된 이미지를 로드하려면 LoadImage 이벤트를 처리합니다. Microsoft Office 응용 프로그램에서는 성능 향상을 위해 리본 메뉴가 표시될 때 솔루션에서 이 이미지를 한 번만 검색합니다. 이후에는 컨트롤 이미지를 변경할 수 없습니다.

컨트롤의 이미지를 로드하려면 LoadImage 이벤트 처리기에 코드를 추가합니다. RibbonLoadImageEventArgs의 ImageName 속성이 컨트롤의 ImageName 속성과 일치하면 Image 속성을 로드할 이미지로 설정합니다.

예제

다음 예제에서는 두 개의 RibbonButton 컨트롤에 대한 이미지를 캐시합니다.

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

1. Office 프로젝트에 리본(비주얼 디자이너) 항목을 추가합니다.

2. 그룹을 사용자 지정 탭에 추가합니다.

3. 두 개의 단추를 그룹에 추가합니다.

4. 두 개의 이미지를 프로젝트 리소스에 추가합니다. 자세한 내용은 방법: 리소스 추가 또는 제거을 참조하십시오.

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;
    }
}

참고 항목

참조

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