RibbonComponent.Tag Свойство

  • Ссылка

Определение

Пространство имен:
Microsoft.Office.Tools.Ribbon
Сборки:
Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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

public:
 property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };
public object Tag { get; set; }
member this.Tag : obj with get, set
Public Property Tag As Object

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

Object

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

Примеры

В следующем примере показано, как задать для массива Employee объектов Tag свойство группы и как получить значение Tag свойства . В этом примере требуется определить класс с именем Employee , который предоставляет String свойство ID , и определить GetEmployees метод, возвращающий массив Employee объектов .

Чтобы запустить этот пример кода, необходимо сначала выполнить следующие действия:

  1. Добавление элемента ленты (visual Designer) в проект, созданный с помощью средств разработки Office в Visual Studio.

  2. Добавьте кнопку в группу Group1по умолчанию .

private void button1_Click(object sender, RibbonControlEventArgs e)
{
    // Set the group's Tag property
    group1.Tag = GetEmployees();

    // Show all customers by retrieving them from the group's Tag property
    foreach (Employee emp in (Employee[])group1.Tag)
    {
        System.Windows.Forms.MessageBox.Show(emp.ID);
    }
}

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Button1.Click
    ' Set the group's Tag property
    Group1.Tag = GetEmployees()

    ' Show all customers by retrieving them from the group's Tag property
    For Each emp As Employee In CType(Group1.Tag, Employee())
        System.Windows.Forms.MessageBox.Show(emp.ID)
    Next
End Sub

Комментарии

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

Обычно свойство используется для Tag хранения данных, тесно связанных с элементом управления. Например, если у вас есть кнопка, отображающая сведения о клиенте, можно сохранить System.Data.DataSet , содержащую журнал заказов клиента, в свойстве кнопки Tag , чтобы быстро получить доступ к данным.

Применяется к