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 控件的图像。
若要运行此代码示例，必须先执行以下步骤：
将功能区 (Visual Designer) 添加到 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;
}
}
注解
事件 LoadImage 使你能够在功能区自定义项中缓存图像，从而提高性能。
默认情况下，每当用户显示包含图像的选项卡时，都会将图像加载到功能区中。 每当以编程方式更改显示图像的控件的属性时，将重新加载图像。
LoadImage使用 事件将图像分配给控件。 当用户选择功能区上的选项卡时，Microsoft Office 应用程序将使用缓存的图像。 如果在运行时修改控件属性，Microsoft Office 应用程序将不会在控件上重新加载图像。 这可以让你获得较小的性能提升。
如果要缓存控件的图像，请设置控件的 ImageName 属性。 LoadImage除非设置至少一个控件的 ImageName 属性，否则不会引发 事件。