RibbonDropDownItem.Tag 属性

2011-08-12

获取或设置与此 RibbonDropDownItem 关联的特定于应用程序的数据。

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

语法

声明
<BindableAttribute(True)> _
<TypeConverterAttribute> _
Property Tag As Object
    Get
    Set

[BindableAttribute(true)]
[TypeConverterAttribute]
Object Tag { get; set; }

属性值

类型：System.Object
一个对象，表示与此 RibbonDropDownItem 关联的特定于应用程序的数据。

备注

从 System.Object 类派生的任何类型都可以分配给该属性。但是，如果在 Visual Studio**“属性”**窗口中设置了 Tag 属性，则只能分配文本。

Tag 属性的一种常见用途是存储与该项密切关联的数据。

示例

下面的示例设置下拉框中 RibbonDropDownItem 的 Tag 属性。

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

将**“功能区(可视化设计器)”**项添加到使用 Visual Studio 中的 Office 开发工具创建的项目中。
将一个下拉框添加到默认组 Group1 中。

Public Class CourseInfo
    Private ID As String
    Public Sub New(ByVal _courseID As String)
        ID = _courseID
    End Sub
End Class

Private Sub AddDropDownTag()
    Dim item1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    item1.Label = "Class 101"
    item1.Tag = New CourseInfo("101")
    DropDown1.Items.Add(item1)
End Sub

public class CourseInfo
{
    private string ID;
    public CourseInfo(string _courseID)
    {
        ID = _courseID;
    }
}

private void AddDropDownTag()
{
    RibbonDropDownItem item1 = this.Factory.CreateRibbonDropDownItem(); 
    item1.Label = "Class 101";
    item1.Tag = new CourseInfo("101");
    dropDown1.Items.Add(item1);
}