RibbonComponent.Tag Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Ribbon

Zestawy:: 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

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia dane specyficzne dla aplikacji skojarzone z tym RibbonComponentplikiem .

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

Wartość właściwości

Object

Obiekt System.Object, który reprezentuje dane specyficzne dla aplikacji, które są skojarzone z tym RibbonComponentelementem .

Przykłady

W poniższym przykładzie pokazano, jak ustawić tablicę Employee obiektów na Tag właściwość grupy i jak pobrać wartość Tag właściwości. W tym przykładzie zdefiniowano klasę o nazwie Employee , która uwidacznia String właściwość ID i że zdefiniowano metodę zwracającą tablicę EmployeeGetEmployees obiektów.

Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:

Dodaj element wstążki (Visual Projektant) do projektu utworzonego przy użyciu narzędzi programistycznych pakietu Office w programie Visual Studio.
Dodaj przycisk do grupy Group1domyślnej .

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

Uwagi

Do tej właściwości można przypisać dowolny typ pochodzący z System.Object klasy. Jeśli jednak właściwość zostanie ustawiona Tag w oknie Właściwości programu Visual Studio, możesz przypisać tylko tekst.

Typowym zastosowaniem właściwości Tag jest przechowywanie danych, które są ściśle skojarzone z kontrolką. Jeśli na przykład masz przycisk, który wyświetla informacje o kliencie, możesz przechowywać System.Data.DataSet element zawierający historię zamówień klienta we właściwości przycisku Tag , aby można było szybko uzyskać dostęp do danych.

Dotyczy

Share via