RibbonDropDownItem.Tag (Propiedad)

Artículo
08/10/2011

Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonDropDownItem.

Espacio de nombres: Microsoft.Office.Tools.Ribbon
Ensamblado: Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)

Sintaxis

'Declaración
<BindableAttribute(True)> _
<TypeConverterAttribute> _
Property Tag As Object
    Get
    Set

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

Valor de propiedad

Tipo: System.Object
Objeto que representa los datos específicos de la aplicación que están asociados a este objeto RibbonDropDownItem.

Comentarios

A esta propiedad se le puede asignar cualquier tipo derivado de la clase System.Object. Sin embargo, si establece la propiedad Tag en la ventana Propiedades de Visual Studio, sólo podrá asignar texto.

La propiedad Tag suele usarse para almacenar los datos que están estrechamente asociados al elemento.

Ejemplos

En el ejemplo siguiente se establece la propiedad Tag de RibbonDropDownItem en un cuadro desplegable.

Para poder ejecutar este ejemplo de código, primero debe seguir este procedimiento:

Agregue un elemento Cinta (diseñador visual) a un proyecto creado mediante las herramientas de desarrollo de Office en Visual Studio.
Agregue un cuadro desplegable al Group1del grupo predeterminado.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.