Propriedade RibbonDropDownItem.Tag

Artigo
05/21/2013

Obtém ou define os dados específicos do aplicativo que estão associados com esse 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

[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ão associados com esse RibbonDropDownItem.

Comentários

Qualquer tipo derivado da classe de System.Object pode ser atribuído à propriedade.Entretanto, se você definir a propriedade de Tag na janela do Visual Studio Propriedades , você só pode atribuir texto.

Um uso comum para a propriedade de Tag é armazenar os dados associados próxima ao item.

Exemplos

O exemplo a seguir define a propriedade de Tag de RibbonDropDownItem em uma caixa suspensa.

Para executar este exemplo de código, primeiro você deve executar as seguintes etapas:

Adicionar um item de Faixa de Opções (Visual Designer) a um projeto criado usando ferramentas de desenvolvimento do Office no Visual Studio.
Adicione uma caixa suspensa ao grupo Group1padrão.

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.