OfficeRibbon.LoadImage 이벤트(2007 시스템)
업데이트: 2007년 11월
하나 이상의 컨트롤에 대해 ImageName 속성이 설정되어 있는 경우 OfficeRibbon이 로드될 때 발생합니다.
네임스페이스: Microsoft.Office.Tools.Ribbon
어셈블리: Microsoft.Office.Tools.Common.v9.0(Microsoft.Office.Tools.Common.v9.0.dll)
구문
<RibbonEventAttribute("loadImage")> _
Public Event LoadImage As EventHandler(Of RibbonLoadImageEventArgs)
Dim instance As OfficeRibbon
Dim handler As EventHandler(Of RibbonLoadImageEventArgs)
AddHandler instance.LoadImage, handler
[RibbonEventAttribute("loadImage")]
public event EventHandler<RibbonLoadImageEventArgs> LoadImage
설명
LoadImage 이벤트를 통해 리본 사용자 지정의 이미지를 캐시하여 성능을 향상시킬 수 있습니다.
이미지는 기본적으로 사용자가 해당 이미지가 포함된 탭을 표시할 때마다 리본 메뉴에 로드됩니다. 이미지는 이미지가 표시되는 컨트롤의 속성을 프로그래밍 방식으로 변경할 때마다 다시 로드됩니다.
컨트롤에 이미지를 할당하려면 LoadImage 이벤트를 사용합니다. 사용자가 리본 메뉴의 탭을 선택하면 Microsoft Office 응용 프로그램에서는 캐시된 이미지를 사용합니다. 런타임에 컨트롤 속성을 수정할 경우에는 Microsoft Office 응용 프로그램에서 해당 컨트롤의 이미지를 다시 로드하지 않습니다. 따라서 성능이 약간 향상될 수 있습니다.
컨트롤의 이미지를 캐시하려면 컨트롤의 ImageName 속성을 설정합니다. 하나 이상의 컨트롤에 대해 ImageName 속성을 설정하지 않으면 LoadImage 이벤트가 발생하지 않습니다.
예제
다음 예제에서는 두 개의 RibbonButton 컨트롤에 대한 이미지를 캐시합니다.
이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.
Visual Studio Tools for Office 프로젝트에 리본(비주얼 디자이너)을 추가합니다.
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;
}
}
권한
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.