通过

RibbonMenu.OfficeImageId 属性 (2007 system)

  • 项目

更新：2007 年 11 月

获取或设置要在菜单上显示的图像（如果要使用内置 Microsoft Office 图标）。

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

语法

声明
Public Property OfficeImageId As String
用法
Dim instance As RibbonMenu
Dim value As String

value = instance.OfficeImageId

instance.OfficeImageId = value

public string OfficeImageId { get; set; }

属性值

类型：System.String

内置 Microsoft Office 图标的 ID，该图标作为此按钮的图标。

备注

OfficeImageId 属性标识该控件所显示的 Office 图标。该属性值是一个字符串，它标识所选图标的 imageMso 值。可以在设计时或运行时设置此属性。如果在运行时更新此属性，则会更新该控件的外观以反映更改。

有关 imageMso 值的列表，请参见 Microsoft 下载中心网页 2007 Office System Add-In: Icons Gallery（2007 Office system 外接程序：图标库）。

如果设置 Image 属性，则忽略此属性。加载 OfficeImageId 属性所标识的图像比加载 Image 属性所标识的图像可能稍快一些，因为这些图像缓存在 Office 应用程序中。

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

示例

下面的示例为菜单分配 Microsoft Office 图标。

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

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

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

  3. 将一个菜单添加到该组。

  4. 将该菜单的“Dynamic”属性设置为 true。

Private Sub SetMenuImage()
    Menu1.OfficeImageId = "HighImportance"
    Menu1.ShowImage = True
End Sub

private void SetMenuImage()
{
    menu1.OfficeImageId = "HighImportance";
    menu1.ShowImage = true;
}

权限

另请参见

参考

RibbonMenu 类

RibbonMenu 成员

Microsoft.Office.Tools.Ribbon 命名空间