RibbonDropDownItem.Tag - свойство

Статья
08/11/2011

Получает или задает данные приложения, связанные с данным объектом 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. Однако при установке свойства Tag в окне Свойства среды Visual Studio можно присваивать ему только текстовые значения.

Обычно свойство Tag применяется для хранения данных, тесно связанных с элементом.

Примеры

В следующем примере устанавливается свойство Tag элемента RibbonDropDownItem в раскрывающемся списке.

Перед выполнением этого примера выполните следующие действия:

Добавьте элемент Лента (визуальный конструктор) в проект, созданный с использованием средств разработки для Office в Visual Studio.
Добавьте раскрывающийся список в группу по умолчанию 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);
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.