Propriedade RibbonDropDownItem.Tag

Artigo
08/01/2011

Obtém ou define os dados específicos do aplicativo que está associados esta RibbonDropDownItem.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)

Sintaxe

'Declaração
<BindableAttribute(True)> _
<TypeConverterAttribute> _
Property Tag As Object
    Get
    Set

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

Valor de propriedade

Tipo: System.Object
Um objeto que representa os dados específicos do aplicativo que está associados esta RibbonDropDownItem.

Comentários

Qualquer tipo derivado de System.Object classe pode ser atribuído a esta propriedade. No entanto, se você definir a Tag propriedade no Visual Studio Propriedades janela, você pode atribuir somente texto.

Um uso comum para o Tag é de propriedade armazenar dados que está intimamente associados do item.

Exemplos

O exemplo a seguir define o Tag propriedade de um RibbonDropDownItem em um drop-down caixa.

Para executar este exemplo de código, realize as seguintes etapas:

Adicionar um a faixa de opções (Visual Designer) item a um projeto criado usando ferramentas de desenvolvimento do Office em Visual Studio.
Adicionar uma caixa suspensa para o grupo padrão Grupo1.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.