RibbonBase.LoadImage 事件

定义

命名空间:

Microsoft.Office.Tools.Ribbon

程序集:

Microsoft.Office.Tools.Common.v4.0.Utilities.dll

如果为一个或多个控件设置 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 

事件类型

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 属性，否则不会引发 事件。