RibbonBase.LoadImage 이벤트

정의

네임스페이스:

Microsoft.Office.Tools.Ribbon

어셈블리:

Microsoft.Office.Tools.Common.v4.0.Utilities.dll

하나 이상의 컨트롤에 대해 ImageName 속성이 설정되어 있는 경우 RibbonBase가 로드될 때 발생합니다.

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;

public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;

member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler 

Public Custom Event LoadImage As RibbonLoadImageEventHandler 

이벤트 유형

RibbonLoadImageEventHandler

예제

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

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

• Office 프로젝트에 리본 메뉴(Visual Designer)를 추가합니다.

• Visual Basic 프로젝트를 사용하는 경우 리본 코드 파일의 맨 위에 다음 문을 추가합니다. Imports Microsoft.Office.Tools.Ribbon

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

Private Sub Ribbon1_LoadImage(sender As Object, 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;  
    }  
}  

설명

이벤트를 LoadImage 사용하면 리본 사용자 지정에서 이미지를 캐시할 수 있으므로 성능이 향상될 수 있습니다.

기본적으로 이미지는 사용자가 이미지가 포함된 탭을 표시할 때마다 리본 메뉴에 로드됩니다. 이미지가 표시되는 컨트롤의 속성을 프로그래밍 방식으로 변경할 때마다 이미지가 다시 로드됩니다.

LoadImage 이벤트를 사용하여 컨트롤에 이미지를 할당합니다. 사용자가 리본에서 탭을 선택하면 Microsoft Office 애플리케이션에서 캐시된 이미지를 사용합니다. 런타임에 컨트롤 속성을 수정하는 경우 Microsoft Office 애플리케이션은 컨트롤의 이미지를 다시 로드하지 않습니다. 이렇게 하면 성능이 약간 향상할 수 있습니다.

컨트롤의 이미지를 캐시하려면 컨트롤의 ImageName 속성을 설정합니다. LoadImage 하나 이상의 컨트롤의 ImageName 속성을 설정하지 않으면 이벤트가 발생하지 않습니다.