OfficeRibbon.LoadImage 事件 (2007 system)
更新：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;
}
}
权限
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。