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;
}
}
权限
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。