Sdílet prostřednictvím


RibbonComponent.Tag Vlastnost

Definice

Získá nebo nastaví data specifická pro aplikaci, která je přidružena k tomuto 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

Hodnota vlastnosti

System.Object, který představuje data specifická pro aplikaci, která jsou přidružena k tomuto RibbonComponentobjektu .

Příklady

Následující příklad ukazuje, jak nastavit pole Employee objektů na Tag vlastnost skupiny a jak načíst hodnotu Tag vlastnosti. Tento příklad vyžaduje, abyste definovali třídu s názvem Employee , která zveřejňuje String vlastnost ID a že jste definovali metodu GetEmployees , která vrací pole Employee objektů.

Chcete-li spustit tento příklad kódu, musíte nejprve provést následující kroky:

  1. Přidejte položku pásu karet (Visual Designer) do projektu vytvořeného pomocí vývojových nástrojů Office v sadě Visual Studio.

  2. Přidejte tlačítko do výchozí skupiny 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

Poznámky

K této vlastnosti lze přiřadit jakýkoli typ odvozený z System.Object třídy . Pokud však nastavíte Tag vlastnost v okně Vlastnosti sady Visual Studio, můžete přiřadit pouze text.

Běžným použitím Tag vlastnosti je ukládání dat, která jsou úzce přidružená k ovládacímu prvku. Pokud máte například tlačítko, které zobrazuje informace o zákazníkovi, můžete do vlastnosti tlačítka Tag uložit System.Data.DataSet soubor obsahující historii objednávek zákazníka, aby k datům bylo možné rychle získat přístup.

Platí pro