Właściwość RibbonDropDownItem.Tag —

Artykuł
05/08/2013

Pobiera lub ustawia dane specyficzne dla aplikacji, która jest skojarzona z tym RibbonDropDownItem.

Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

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

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

Wartość właściwości

Typ: System.Object
Obiekt, który reprezentuje dane specyficzne dla aplikacji, który jest skojarzony z tym RibbonDropDownItem.

Uwagi

Dowolnego typu, pochodzące z System.Object klasy mogą być przypisane do tej właściwości.Jednakże jeśli ustawisz Tag właściwość w programie Visual Studio Właściwości okna, można przypisać tylko tekst.

Typowe zastosowanie dla Tag właściwość jest do przechowywania danych, która jest ściśle związany z elementem.

Przykłady

W poniższym przykładzie Tag właściwość RibbonDropDownItem w polu rozwijanym.

Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:

Dodać wstążki (Visual Designer) element, aby projekt utworzony przy użyciu narzędzia programowania pakietu Office w programie Visual Studio.
Dodawanie menu rozwijanym do domyślnej grupy grupa1.

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..