RibbonComponent.Tag Vlastnost

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Ribbon

Sestavení:: 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

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Object

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:

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.
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

Sdílet prostřednictvím