通过

RibbonLoadImageEventArgs 接口

  • 项目

为 LoadImage 事件提供数据。

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

语法

声明
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs

[GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")]
public interface RibbonLoadImageEventArgs

RibbonLoadImageEventArgs 类型公开以下成员。

属性

  名称 说明
公共属性 Image 获取或设置要加载的功能区控件的图像。
公共属性 ImageName 获取功能区中正在加载的图像的名称。

页首

备注

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

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

示例

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

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

  1. 将一个**“功能区(可视化设计器)”**项添加到 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;
    }
}

请参见

参考

Microsoft.Office.Tools.Ribbon 命名空间