通过

RibbonLoadImageEventArgs 类 (2007 system)

  • 项目

更新：2007 年 11 月

为 LoadImage 事件提供数据。

命名空间：  Microsoft.Office.Tools.Ribbon
程序集：  Microsoft.Office.Tools.Common.v9.0（在 Microsoft.Office.Tools.Common.v9.0.dll 中）

语法

声明
Public NotInheritable Class RibbonLoadImageEventArgs _
    Inherits EventArgs
用法
Dim instance As RibbonLoadImageEventArgs

public sealed class RibbonLoadImageEventArgs : EventArgs

备注

如果希望加载由控件的 ImageName 属性标识的图像，可处理 LoadImage 事件。为了提高性能，Microsoft Office 应用程序仅在显示功能区时从解决方案中检索一次此图像。此后将无法更改该控件图像。

若要为控件加载图像，请在 LoadImage 事件处理程序中添加代码。如果 RibbonLoadImageEventArgs 的 ImageName 属性与控件的 ImageName 属性匹配，请将 Image 属性设置为要加载的图像。

示例

下面的示例为两个 RibbonButton 控件缓存图像。

若要运行此代码示例，必须先执行下列步骤：

  1. 将一个“功能区(可视化设计器)”项添加到 Visual Studio Tools for Office 项目。

  2. 在自定义选项卡中添加一个组。

  3. 在该组中添加两个按钮。

  4. 在项目资源中添加两个图像。有关更多信息，请参见如何：添加或移除资源。

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal 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;
    }
}

继承层次结构

System.Object
  System.EventArgs
    Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventArgs

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

另请参见

参考

RibbonLoadImageEventArgs 成员

Microsoft.Office.Tools.Ribbon 命名空间