RibbonDropDownItem.Tag – vlastnost

Článek
05/14/2013

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

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

Syntaxe

'Deklarace
<BindableAttribute(True)> _
<TypeConverterAttribute> _
Property Tag As Object

[BindableAttribute(true)]
[TypeConverterAttribute]
Object Tag { get; set; }

Hodnota vlastnosti

Typ: System.Object
Objekt, který představuje data specifická pro aplikaci, který je spojen s tímto RibbonDropDownItem.

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 spojena s položkou.

Příklady

Následující příklad nastavuje Tag vlastnost RibbonDropDownItem v rozevíracím seznamu.

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řidejte rozevírací nabídku do výchozí skupiny skupina1.

Public Class CourseInfo
    Private ID As String
    Public Sub New(ByVal _courseID As String)
        ID = _courseID
    End Sub
End Class

Private Sub AddDropDownTag()
    Dim item1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    item1.Label = "Class 101"
    item1.Tag = New CourseInfo("101")
    DropDown1.Items.Add(item1)
End Sub

public class CourseInfo
{
    private string ID;
    public CourseInfo(string _courseID)
    {
        ID = _courseID;
    }
}

private void AddDropDownTag()
{
    RibbonDropDownItem item1 = this.Factory.CreateRibbonDropDownItem(); 
    item1.Label = "Class 101";
    item1.Tag = new CourseInfo("101");
    dropDown1.Items.Add(item1);
}

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.