RibbonComboBox.OfficeImageId 属性

获取或设置 RibbonComboBox 上显示的图像(如果要使用内置 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 筛选器图标。

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

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

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

  3. 将一个组合框添加到组中。

Private Sub SetComboBoxImage()
    ComboBox1.OfficeImageId = "FilterToggleFilter"
    ComboBox1.ShowImage = True
End Sub
private void SetComboBoxImage()
{
    comboBox1.OfficeImageId = "FilterToggleFilter";
    comboBox1.ShowImage = true;
}

.NET Framework 安全性

请参见

参考

RibbonComboBox 接口

Microsoft.Office.Tools.Ribbon 命名空间

其他资源

功能区对象模型概述