Proprietà RibbonDropDownItem.Tag

Articolo
08/11/2011

Ottiene o imposta dati specifici dell'applicazione associati a RibbonDropDownItem.

Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
<BindableAttribute(True)> _
<TypeConverterAttribute> _
Property Tag As Object
    Get
    Set

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

Valore proprietà

Tipo: System.Object
Oggetto che rappresenta dati specifici dell'applicazione associati a RibbonDropDownItem.

Note

A questa proprietà può essere assegnato qualsiasi tipo derivato dalla classe System.Object. Tuttavia, se la proprietà Tag nella finestra Proprietà di Visual Studio è impostata, è possibile unicamente assegnare testo.

La proprietà Tag viene in genere utilizzata per archiviare dati strettamente associati all'elemento.

Esempi

Nell'esempio seguente viene impostata la proprietà Tag di un oggetto RibbonDropDownItem in una casella di riepilogo a discesa.

Per eseguire questo esempio di codice, effettuare innanzitutto le seguenti operazioni:

Aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto creato utilizzando gli strumenti di sviluppo Office di Visual Studio.
Aggiungere una casella di riepilogo a discesa al gruppo predefinito Group1.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.