RibbonDropDownItem.Tag Свойство (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возврат или установка данных приложения, связанных с этим объектом RibbonDropDownItem.

Пространство имен: Microsoft.Office.Tools.Ribbon
Сборка: Microsoft.Office.Tools.Common.v9.0 (в Microsoft.Office.Tools.Common.v9.0.dll)

Синтаксис

'Декларация
<BindableAttribute(True)> _
<TypeConverterAttribute(GetType(StringConverter))> _
Public Property Tag As Object
'Применение
Dim instance As RibbonDropDownItem
Dim value As Object

value = instance.Tag

instance.Tag = value

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

Значение свойства

Тип: System.Object
Объект, представляющий данные приложения, связанные с этим объектом RibbonDropDownItem.

Заметки

Данному свойству можно назначить любой тип, производный от класса System.Object. Однако при установке свойства Tag в окне Свойства среды Visual Studio можно присваивать ему только текстовые значения.

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

Примеры

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

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

Добавьте элемент Лента (визуальный конструктор) в проект Visual Studio Tools for 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 = New RibbonDropDownItem()
    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 = new RibbonDropDownItem();
    item1.Label = "Class 101";
    item1.Tag = new CourseInfo("101");
    dropDown1.Items.Add(item1);
}

Разрешения

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