RibbonButton.Image 属性 (2007 system)
更新：2007 年 11 月
获取或设置在按钮上显示的图像。
命名空间： Microsoft.Office.Tools.Ribbon
程序集： Microsoft.Office.Tools.Common.v9.0（在 Microsoft.Office.Tools.Common.v9.0.dll 中）
语法
声明
Public Property Image As Image
用法
Dim instance As RibbonButton
Dim value As Image
value = instance.Image
instance.Image = value
public Image Image { get; set; }
属性值
在按钮上显示的 Image。
备注
建议使用 PNG 图像格式，因为 PNG 格式的图像通过其 alpha 通道支持透明度。
Image 属性标识该控件所显示的图像。可以在设计时或运行时设置此属性。如果在运行时更新此属性，则会更新该控件的外观以反映更改。
如果设置 Image 属性，则将忽略 OfficeImageId 和 ImageName 属性。虽然 Image 属性与其他两个属性相比可提供更多的控制，但由于每次更新控件时都要将该图像对象发送到 Office 应用程序，该属性的速度可能比较慢。
若要使该控件显示图像，ShowImage 属性必须为 true。如果在设计时设置 Image 属性，Visual Studio Tools for Office 自动将 ShowImage 属性设置为 true。如果在运行时设置 Image 属性，则必须在代码中将 ShowImage 属性设置为 true。
示例
下面的示例设置两个按钮的 Image 属性。若要运行此代码示例，必须先执行下列步骤：
将一个“功能区(可视化设计器)”项添加到 Visual Studio Tools for Office 项目。
在自定义选项卡中添加一个组。
在该组中添加两个按钮。
在项目资源中添加两个图像。有关更多信息，请参见如何：添加或移除资源。
Private Sub LoadImages()
button1.ShowImage = True
CustomerButton.ShowImage = True
Button1.Image = My.Resources.Image1
CustomerButton.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;
}
权限
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。
另请参见
参考
Microsoft.Office.Tools.Ribbon 命名空间