如果为一个或多个控件设置 ImageName 属性，则在 RibbonBase 加载时发生。
命名空间： Microsoft.Office.Tools.Ribbon
程序集： Microsoft.Office.Tools.Common.v4.0.Utilities（在 Microsoft.Office.Tools.Common.v4.0.Utilities.dll 中）
语法
声明
Public Event LoadImage As RibbonLoadImageEventHandler
public event RibbonLoadImageEventHandler LoadImage
备注
使用 LoadImage 事件可以在功能区自定义项中缓存图像，这样可以提高性能。
默认情况下，每次用户显示包含图像的选项卡时，该图像将加载到功能区中。每当以编程方式更改显示图像的控件的属性时，将重新加载图像。
使用 LoadImage 事件可为控件指定图像。当用户选择功能区上的选项卡时，Microsoft Office 应用程序使用缓存的图像。如果在运行时修改控件属性，则 Microsoft Office 应用程序将不重新加载控件上的图像。这会略微提高性能。
如果要缓存控件的图像，请设置控件的 ImageName 属性。除非设置至少一个控件的 ImageName 属性，否则不引发 LoadImage 事件。
示例
下面的示例为两个 RibbonButton 控件缓存图像。
若要运行此代码示例，必须先执行下列步骤：
将一个**“功能区(可视化设计器)”**添加到 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;
}
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。