RibbonComponent.Tag Properti

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools.Ribbon

Rakitan:: 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

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur data khusus aplikasi yang terkait dengan ini 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

Nilai Properti

Object

System.Object yang mewakili data khusus aplikasi yang terkait dengan ini RibbonComponent.

Contoh

Contoh berikut menunjukkan cara mengatur array Employee objek ke Tag properti grup dan cara mengambil nilai Tag properti . Contoh ini mengharuskan Anda telah menentukan kelas yang disebut Employee yang mengekspos String properti ID dan Anda telah menentukan GetEmployees metode yang mengembalikan array Employee objek.

Untuk menjalankan contoh kode ini, Anda harus terlebih dahulu melakukan langkah-langkah berikut:

Tambahkan item Pita (Visual Designer) ke proyek yang dibuat dengan menggunakan alat pengembangan Office di Visual Studio.
Tambahkan tombol ke grup Group1default .

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

Keterangan

Jenis apa pun yang System.Object berasal dari kelas dapat ditetapkan ke properti ini. Namun, jika Anda mengatur Tag properti di jendela Properti Visual Studio, Anda hanya dapat menetapkan teks.

Penggunaan umum untuk Tag properti adalah menyimpan data yang terkait erat dengan kontrol. Misalnya, jika Anda memiliki tombol yang menampilkan informasi tentang pelanggan, Anda mungkin menyimpan System.Data.DataSet yang berisi riwayat pesanan pelanggan di properti tombol Tag sehingga data dapat diakses dengan cepat.

Berlaku untuk

Bagikan melalui