RibbonComponent.Tag – vlastnost

Článek
05/14/2013

Získá nebo nastaví specifická data, který je spojen s tímto RibbonComponent.

Obor názvů: Microsoft.Office.Tools.Ribbon
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)
Microsoft.Office.Tools.Common.v4.0.Utilities (v Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Syntaxe

'Deklarace
Property Tag As Object

Object Tag { get; set; }

Hodnota vlastnosti

Typ: System.Object
System.Object , Která představuje data specifické pro aplikaci, která je spojena s tímto RibbonComponent.

Poznámky

Libovolného typu odvozeného z System.Object třídy lze přiřadit k této vlastnosti.Však pokud jste nastavili Tag vlastnost v aplikaci Visual Studio Vlastnosti okna, můžete přiřadit pouze text.

Běžné použití pro Tag vlastnost je k ukládání dat, který je úzce svázán s ovládacím prvkem.Například, máte-li tlačítko, které zobrazí informace o zákazníkovi, může být uložena System.Data.DataSet , který obsahuje historii objednávek zákazníka na tlačítku Tag vlastnost tak, aby data lze rychle získat přístup.

Příklady

Následující příklad ukazuje, jak nastavit pole zaměstnance objektů Tag vlastnost skupiny a jak načíst hodnotu Tag vlastnost.Tento příklad vyžaduje, aby jste definovali třídu nazvanou zaměstnance , vystavuje String vlastnost ID a že jste definovali GetEmployees metodu, která vrací pole zaměstnance objekty.

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

Přidat pásu karet (vizuální návrhář) položky do projektu vytvořeného pomocí nástrojů pro vývoj Office v sadě Visual Studio.
Přidání tlačítka do výchozí skupiny skupina1.

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

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);
    }
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

RibbonComponent Rozhraní

Microsoft.Office.Tools.Ribbon – obor názvů

Sdílet prostřednictvím