Bagikan melalui

Panduan: Membuat tab kustom dengan menggunakan Perancang Pita

  • Artikel

Dengan menggunakan Perancang Pita, Anda bisa membuat tab kustom lalu menambahkan dan memosisikan kontrol di atasnya.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen untuk Excel. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Panduan ini mengilustrasikan tugas-tugas berikut:

Catatan

Komputer Anda mungkin memperlihatkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam petunjuk berikut. Edisi Visual Studio yang Anda miliki dan setelan yang Anda gunakan menentukan elemen-elemen ini. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE Visual Studio.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

Membuat proyek buku kerja Excel

Langkah-langkah untuk menggunakan Perancang Pita hampir identik untuk semua aplikasi Office likasi. Contoh ini menggunakan buku kerja Excel.

Untuk membuat proyek buku kerja Excel

  • Buat proyek buku kerja Excel dengan nama MyExcelRibbon. Untuk informasi selengkapnya, lihat Cara: Membuat Proyek Office di Visual Studio.

    Visual Studio membuka buku kerja baru di perancang dan menambahkan proyek MyExcelRibbon ke Penjelajah Solusi.

Membuat panel tindakan

Tambahkan dua panel tindakan kustom ke proyek. Anda nantinya akan menambahkan tombol yang memperlihatkan dan menyembunyikan panel tindakan ini ke tab kustom.

Untuk membuat panel tindakan

  1. Pada menu Proyek, klik Tambahkan Item Baru.

  2. Dalam kotak dialog Tambahkan Item Baru, pilih TindakanPaneKontrol, lalu pilih Tambahkan.

    File ActionsPaneControl1.cs atau ActionsPaneControl1.vb terbuka di perancang.

  3. Dari tab Kontrol Umum kotak Alat, tambahkan label ke permukaan perancang.

  4. Di jendela Properti , atur properti Teks label1 ke Panel Tindakan 1.

  5. Ulangi langkah 1 hingga 5 untuk membuat panel tindakan dan label kedua. Atur properti Teks dari label kedua ke Panel Tindakan 2.

Membuat tab kustom

Salah satu panduan desain aplikasi Office likasi adalah bahwa pengguna harus selalu memiliki kontrol atas UI aplikasi Office likasi. Untuk menambahkan kapabilitas ini untuk panel tindakan, Anda bisa menambahkan tombol yang memperlihatkan dan menyembunyikan setiap panel tindakan dari tab kustom pada pita. Untuk membuat tab kustom, tambahkan item Pita (Visual Designer) ke proyek. Perancang membantu Anda menambahkan dan memosisikan kontrol, mengatur properti kontrol, dan menangani peristiwa kontrol.

Untuk membuat tab kustom

  1. Pada menu Proyek, klik Tambahkan Item Baru.

  2. Dalam kotak dialog Tambahkan Item Baru, pilih Pita (Visual Designer).

  3. Ubah nama pita baru menjadi MyRibbon, dan pilih Tambahkan.

    File MyRibbon.cs atau MyRibbon.vb terbuka di Perancang Pita dan menampilkan tab dan grup default.

  4. Di Perancang Pita, pilih tab default.

  5. Di jendela Properti , perluas properti ControlId , lalu atur properti ControlIdType ke Kustom.

  6. Atur properti Label ke Tab Kustom Saya.

  7. Di Perancang Pita, pilih grup1.

  8. Di jendela Properti , atur Label ke Manajer Panel Tindakan.

  9. Dari tab Kontrol Pita Office dari Kotak Alat, seret tombol ke grup1.

  10. Pilih tombol1.

  11. Di jendela Properti , atur Label ke Perlihatkan Panel Tindakan 1.

  12. Tambahkan tombol kedua ke grup1, dan atur properti Label ke Tampilkan Panel Tindakan 2.

  13. Dari tab Kontrol Pita Office dari Kotak Alat, seret kontrol ToggleButton ke grup1.

  14. Atur properti Label ke Sembunyikan Panel Tindakan.

Sembunyikan dan perlihatkan panel tindakan dengan menggunakan tombol pada tab kustom

Langkah terakhir adalah menambahkan kode yang merespons pengguna. Tambahkan penanganan aktivitas untuk Click peristiwa dua tombol dan Click peristiwa tombol pengalih. Tambahkan kode ke penanganan aktivitas ini untuk mengaktifkan persembunyian dan memperlihatkan panel tindakan.

Untuk menyembunyikan dan memperlihatkan panel tindakan dengan menggunakan tombol di tab kustom

  1. Di Penjelajah Solusi, buka menu pintasan untuk MyRibbon.cs atau MyRibbon.vb, lalu pilih Tampilkan Kode.

  2. Tambahkan kode berikut ke bagian MyRibbon atas kelas. Kode ini membuat dua objek panel tindakan.

    ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();

  3. Ganti metode MyRibbon_Load dengan kode berikut. Kode ini menambahkan objek panel tindakan ke Controls koleksi dan menyembunyikan objek dari tampilan. Kode Visual C# juga melampirkan delegasi ke beberapa peristiwa kontrol pita.

    private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
{
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
    actionsPane1.Hide();
    actionsPane2.Hide();
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;

    this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.button1_Click);
    this.button2.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.button2_Click);
    this.toggleButton1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.toggleButton1_Click);


}

  4. Tambahkan tiga metode penanganan aktivitas berikut ke MyRibbon kelas . Metode ini menangani Click peristiwa dua tombol dan Click peristiwa tombol pengalih. Penanganan aktivitas untuk tombol1 dan tombol2 memperlihatkan panel tindakan alternatif. Penanganan aktivitas untuk beralihButton1 memperlihatkan dan menyembunyikan panel tindakan aktif.

    private void button1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane2.Hide();
    actionsPane1.Show();
    toggleButton1.Checked = false;
}

private void button2_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane1.Hide();
    actionsPane2.Show();
    toggleButton1.Checked = false;

}

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    if (toggleButton1.Checked == true)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
    }
    else
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    }

}

Menguji Tab kustom

Saat Anda menjalankan proyek, Excel dimulai, dan tab Tab Kustom Saya muncul di pita. Pilih tombol pada Tab Kustom Saya untuk memperlihatkan dan menyembunyikan panel tindakan.

Untuk menguji tab kustom

  1. Tekan F5 untuk menjalankan proyek Anda.

  2. Pilih tab Kustom Saya.

  3. Di grup Pengelola Panel Tindakan Kustom, pilih Perlihatkan Panel Tindakan 1.

    Panel tindakan muncul dan menampilkan panel Tindakan label 1.

  4. Pilih Perlihatkan Panel Tindakan 2.

    Panel tindakan muncul dan menampilkan label Panel Tindakan 2.

  5. Pilih Sembunyikan Panel Tindakan.

    Panel tindakan tidak lagi terlihat.

Langkah berikutnya

Anda bisa mempelajari selengkapnya tentang cara mengkustomisasi UI Office dari topik-topik ini:

  • Tambahkan UI berbasis konteks ke kustomisasi tingkat dokumen apa pun. Untuk informasi selengkapnya, lihat Gambaran umum panel Tindakan.

  • Perluas formulir Microsoft Office Outlook standar atau kustom. Untuk informasi selengkapnya, lihat Panduan: Mendesain wilayah formulir Outlook.

Konten terkait