RibbonMenu.OfficeImageId 属性
获取或设置要在菜单上显示的图像(如果要使用内置 Microsoft Office 图标)。
命名空间: Microsoft.Office.Tools.Ribbon
程序集: Microsoft.Office.Tools.Common(在 Microsoft.Office.Tools.Common.dll 中)
语法
声明
Property OfficeImageId As String
string OfficeImageId { get; set; }
属性值
类型:System.String
内置 Microsoft Office 图标的 ID,该图标作为此按钮的图标。
备注
OfficeImageId 属性标识该控件所显示的 Office 图标。 该属性值是一个字符串,它标识所选图标的 imageMso 值。 可以在设计时或运行时设置此属性。 如果在运行时更新此属性,则会更新该控件的外观以反映更改。
有关 imageMso 值列表,请参见 Microsoft 下载中心页 外接程序的 Office 2010:图标库。
如果设置 Image 属性,则忽略此属性。 加载 OfficeImageId 属性所标识的图像比加载 Image 属性所标识的图像可能稍快一些,因为这些图像缓存在 Office 应用程序中。
若要使该控件显示图像,ShowImage 属性必须为 true。 如果在设计时设置了 OfficeImageId 属性,Visual Studio 就会自动将 ShowImage 属性设置为 true。 如果在运行时设置 OfficeImageId 属性,则必须在代码中将 ShowImage 属性设置为 true。
示例
下面的示例为菜单分配 Microsoft Office 图标。
若要运行此代码示例,必须先执行下列步骤:
将一个**“功能区(可视化设计器)”**项添加到 Office 项目中。
在自定义选项卡中添加一个组。
将一个菜单添加到该组。
将该菜单的**“Dynamic”**属性设置为 true。
Private Sub SetMenuImage()
Menu1.OfficeImageId = "HighImportance"
Menu1.ShowImage = True
End Sub
private void SetMenuImage()
{
menu1.OfficeImageId = "HighImportance";
menu1.ShowImage = true;
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。