RibbonBase.LoadImage 이벤트
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
하나 이상의 컨트롤에 대해 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 이벤트 유형
예제
다음 예제에서는 두 컨트롤 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 속성을 설정하지 않으면 이벤트가 발생하지 않습니다.