RibbonComponent.Tag – vlastnost
Získá nebo nastaví specifická data 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 aplikace, který je spojen s tímto RibbonComponent.
Poznámky
Libovolného typu odvozeného z System.Object třídy mohou být přiřazeny k této vlastnosti.Však nastavíte-li Tag vlastnosti v aplikaci Visual Studio Vlastnosti okna, můžete přiřadit pouze text.
Pro běžné použití Tag vlastnost je ukládat data, která je úzce svázán s ovládacím prvkem.Například, pokud je tlačítko, které zobrazí informace o zákazníkovi, lze uložit System.Data.DataSet , který obsahuje historii objednávek zákazníka na tlačítku Tag vlastnost, takže lze data rychle přistupovat.
Příklady
Následující příklad ukazuje, jak nastavit matici zaměstnance objektů Tag vlastnost skupiny a jak načíst hodnoty Tag vlastnost.Tento příklad vyžaduje, že jste definovali třídu nazvanou zaměstnance která poskytuje String vlastnost ID a který je definován GetEmployees metodu, která vrací pole zaměstnance objekty.
Chcete-li spustit příklad kódu, musíte nejprve provést následující kroky:
Přidat pásu karet (vizuální návrhář) položku do projektu vytvořeného pomocí vývojářských nástrojů sady Office v aplikaci 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.