RibbonComponent.Tag Proprietà

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Ribbon

Assembly:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

public:
 property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };

public object Tag { get; set; }

member this.Tag : obj with get, set

Public Property Tag As Object

Valore della proprietà

Object

Oggetto System.Object che rappresenta i dati specifici dell'applicazione associati a questo RibbonComponentoggetto .

Esempio

Nell'esempio seguente viene illustrato come impostare una matrice di oggetti sulla Tag proprietà di Employee un gruppo e su come recuperare il valore della Tag proprietà. In questo esempio è necessaria una classe denominata Employee che espone la String proprietà ID e che è stato definito un GetEmployees metodo che restituisce una matrice di Employee oggetti.

Per eseguire questo esempio di codice, è necessario eseguire prima i passaggi seguenti:

Aggiungere un elemento della barra multifunzione (Visual Designer) a un progetto creato usando gli strumenti di sviluppo di Office in Visual Studio.
Aggiungere un pulsante al gruppo Group1predefinito .

private void button1_Click(object sender, RibbonControlEventArgs e)
{
    // Set the group's Tag property
    group1.Tag = GetEmployees();

    // Show all customers by retrieving them from the group's Tag property
    foreach (Employee emp in (Employee[])group1.Tag)
    {
        System.Windows.Forms.MessageBox.Show(emp.ID);
    }
}

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Button1.Click
    ' Set the group's Tag property
    Group1.Tag = GetEmployees()

    ' Show all customers by retrieving them from the group's Tag property
    For Each emp As Employee In CType(Group1.Tag, Employee())
        System.Windows.Forms.MessageBox.Show(emp.ID)
    Next
End Sub

Commenti

Qualsiasi tipo derivato dalla System.Object classe può essere assegnato a questa proprietà. Tuttavia, se si imposta la Tag proprietà nella finestra Proprietà di Visual Studio, è possibile assegnare solo testo.

Un uso comune per la proprietà consiste nell'archiviare Tag i dati strettamente associati al controllo. Ad esempio, se si dispone di un pulsante che visualizza informazioni su un cliente, è possibile archiviare un System.Data.DataSet oggetto contenente la cronologia degli ordini del cliente nella proprietà del Tag pulsante in modo che i dati possano essere accessibili rapidamente.

Si applica a

Condividi tramite