다음을 통해 공유

RibbonLoadImageEventArgs 클래스(2007 시스템)

  • 아티클

업데이트: 2007년 11월

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

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

구문

Public NotInheritable Class RibbonLoadImageEventArgs _
    Inherits EventArgs

Dim instance As RibbonLoadImageEventArgs

public sealed class RibbonLoadImageEventArgs : EventArgs

설명

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

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

예제

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

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

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

상속 계층 구조

System.Object
  System.EventArgs
    Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventArgs

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

참고 항목

참조

RibbonLoadImageEventArgs 멤버

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