通过

RibbonButton.Image 属性

获取或设置在按钮上显示的图像。

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

语法

声明
Property Image As Image
    Get
    Set

Image Image { get; set; }

属性值

类型：System.Drawing.Image
在按钮上显示的 Image。

备注

建议使用 PNG 图像格式，因为 PNG 格式的图像通过其 alpha 通道支持透明度。

Image 属性标识该控件所显示的图像。 可以在设计时或运行时设置此属性。 如果在运行时更新此属性，则会更新该控件的外观以反映更改。

如果设置 Image 属性，则将忽略 OfficeImageId 和 ImageName 属性。 虽然 Image 属性与其他两个属性相比可提供更多的控制，但由于每次更新控件时都要将该图像对象发送到 Office 应用程序，该属性的速度可能比较慢。

若要使该控件显示图像，ShowImage 属性必须为 true。 如果在设计时设置了 Image 属性，Visual Studio 就会自动将 ShowImage 属性设置为 true。 如果在运行时设置 Image 属性，则必须在代码中将 ShowImage 属性设置为 true。

示例

下面的示例设置两个按钮的 Image 属性。 若要运行此代码示例，必须先执行下列步骤：

  1. 将**“功能区(可视化设计器)”**项添加到使用 Visual Studio 中的 Office 开发工具创建的项目中。

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

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

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

Private Sub LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}

.NET Framework 安全性

请参见

参考

RibbonButton 接口

Microsoft.Office.Tools.Ribbon 命名空间

其他资源

功能区概述

功能区对象模型概述