RibbonDropDownItem.Tag, propriété

Article
05/16/2013

Obtient ou définit des données spécifiques à l'application associées à ce RibbonDropDownItem.

Espace de noms : Microsoft.Office.Tools.Ribbon
Assembly : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)

Syntaxe

'Déclaration
<BindableAttribute(True)> _
<TypeConverterAttribute> _
Property Tag As Object

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

Valeur de propriété

Type : System.Object
Objet qui représente des données spécifiques à l'application associées à ce RibbonDropDownItem.

Notes

Vous pouvez assigner n'importe quel type dérivé de la classe System.Object à cette propriété.Toutefois, si vous définissez la propriété Tag dans la fenêtre Propriétés de Visual Studio, vous pouvez assigner le texte uniquement.

La propriété Tag est souvent utilisée pour stocker des données étroitement liées à l'élément.

Exemples

L'exemple suivant définit la propriété Tag de RibbonDropDownItem dans une zone déroulante.

Pour exécuter cet exemple de code, vous devez exécuter tout d'abord les étapes suivantes :

Ajoutez un élément Ruban (Concepteur visuel) à un projet créé en utilisant les outils de développement Office dans Visual Studio.
Ajoutez une zone déroulante au groupe par défaut 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);
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.