通过

RibbonBase.LoadImage 事件

  • 项目

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

请参见

参考

RibbonBase 类

Microsoft.Office.Tools.Ribbon 命名空间