RibbonDropDownItem.OfficeImageId 属性

获取或设置 RibbonDropDownItem 上显示的图像(如果要使用内置 Microsoft Office 图标)。

命名空间:  Microsoft.Office.Tools.Ribbon
程序集:  Microsoft.Office.Tools.Common(在 Microsoft.Office.Tools.Common.dll 中)

语法

声明
Property OfficeImageId As String
    Get
    Set
string OfficeImageId { get; set; }

属性值

类型:System.String
要在 RibbonDropDownItem 上显示的图像(如果要使用内置 Microsoft Office 图标)。

备注

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

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

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

示例

下面的示例为下拉框中的两个项分配 Microsoft Office 图标。

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

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

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

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

Private Sub PopulateDropDown()
    Dim status1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status1.Label = "Away"
    status1.OfficeImageId = "PersonaStatusAway"
    DropDown1.Items.Add(status1)
    Dim status2 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status2.Label = "Online"
    status2.OfficeImageId = "PersonaStatusOnline"
    DropDown1.Items.Add(status2)
End Sub
private void PopulateDropDown()
{
    RibbonDropDownItem status1 = this.Factory.CreateRibbonDropDownItem();
    status1.Label = "Away";
    status1.OfficeImageId = "PersonaStatusAway";
    dropDown1.Items.Add(status1);
    RibbonDropDownItem status2 = this.Factory.CreateRibbonDropDownItem();
    status2.Label = "Online";
    status2.OfficeImageId = "PersonaStatusOnline";
    dropDown1.Items.Add(status2);
}

.NET Framework 安全性

请参见

参考

RibbonDropDownItem 接口

Microsoft.Office.Tools.Ribbon 命名空间

其他资源

功能区对象模型概述