Panduan: Menyinkronkan panel tugas kustom dengan tombol Pita

Panduan ini menunjukkan cara membuat panel tugas kustom yang bisa disembunyikan atau ditampilkan pengguna dengan mengklik tombol alih pada pita. Anda harus selalu membuat elemen antarmuka pengguna (UI), seperti tombol, yang dapat diklik pengguna untuk menampilkan atau menyembunyikan panel tugas kustom Anda, karena Microsoft aplikasi Office likasi tidak menyediakan cara default bagi pengguna untuk menampilkan atau menyembunyikan panel tugas kustom.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek Add-in VSTO untuk Outlook. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Meskipun panduan ini menggunakan Excel secara khusus, konsep yang ditunjukkan oleh panduan berlaku untuk aplikasi apa pun yang tercantum di atas.

Panduan ini mengilustrasikan tugas-tugas berikut:

• Merancang UI panel tugas kustom.

• Menambahkan tombol alih ke Pita.

• Menyinkronkan tombol alih dengan panel tugas kustom.

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:

• Edisi Visual Studio yang menyertakan alat pengembang Microsoft Office. Untuk informasi selengkapnya, lihat Mengonfigurasi komputer untuk mengembangkan solusi Office.

• Microsoft Excel atau Microsoft Excel 2013 .

Membuat proyek Add-in

Dalam langkah ini, Anda akan membuat proyek Add-in VSTO untuk Excel.

Untuk membuat proyek baru

1. Buat proyek Add-in Excel dengan nama SynchronizeTaskPaneAndRibbon, menggunakan templat proyek Add-in Excel. Untuk informasi selengkapnya, lihat Cara: Membuat proyek Office di Visual Studio.

   Visual Studio membuka file kode ThisAddIn.cs atau ThisAddIn.vb dan menambahkan proyek SynchronizeTaskPaneAndRibbon ke Penjelajah Solusi.

Menambahkan tombol alih ke pita

Salah satu panduan desain aplikasi Office likasi adalah bahwa pengguna harus selalu memiliki kontrol atas UI aplikasi Office likasi. Untuk memungkinkan pengguna mengontrol panel tugas kustom, Anda bisa menambahkan tombol pengalih Pita yang memperlihatkan dan menyembunyikan panel tugas. Untuk membuat tombol alih, tambahkan item Pita (Visual Designer) ke proyek. Perancang membantu Anda menambahkan dan memosisikan kontrol, mengatur properti kontrol, dan menangani peristiwa kontrol. Untuk informasi selengkapnya, lihat Perancang pita.

Untuk menambahkan tombol alih ke pita

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 KelolaTaskPaneRibbon, dan klik Tambahkan.

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

4. Di Perancang Pita, klik grup1.

5. Di jendela Properti , atur properti Label ke Pengelola Panel Tugas.

6. Dari tab Kontrol Pita Office dari Kotak Alat, seret Tombol Alih ke grup Pengelola Panel Tugas.

7. Klik tombol alihButton1.

8. Di jendela Properti , atur properti Label ke Perlihatkan Panel Tugas.

Mendesain antarmuka pengguna panel tugas kustom

Tidak ada perancang visual untuk panel tugas kustom, tetapi Anda bisa mendesain kontrol pengguna dengan tata letak yang Anda inginkan. Nanti dalam panduan ini, Anda akan menambahkan kontrol pengguna ke panel tugas kustom.

Untuk mendesain antarmuka pengguna panel tugas kustom

1. Pada menu Proyek , klik Tambahkan Kontrol Pengguna.

2. Dalam kotak dialog Tambahkan Item Baru, ubah nama kontrol pengguna menjadi TaskPaneControl, dan klik Tambahkan.

   Kontrol pengguna terbuka di perancang.

3. Dari tab Kontrol Umum kotak Alat, seret kontrol TextBox ke kontrol pengguna.

Membuat panel tugas kustom

Untuk membuat panel tugas kustom saat Add-in VSTO dimulai, tambahkan kontrol pengguna ke panel tugas di Startup penanganan aktivitas Add-in VSTO. Secara default, panel tugas kustom tidak akan terlihat. Nanti dalam panduan ini, Anda akan menambahkan kode yang akan menampilkan atau menyembunyikan panel tugas saat pengguna mengklik tombol alih yang Anda tambahkan ke pita.

Untuk membuat panel tugas kustom

1. Di Penjelajah Solusi, perluas Excel.

2. Klik kanan ThisAddIn.cs atau ThisAddIn.vb dan klik Tampilkan Kode.

3. Tambahkan kode berikut ke kelas ThisAddIn. Kode ini menyatakan instans TaskPaneControl sebagai anggota ThisAddIn.

   C#

   private TaskPaneControl taskPaneControl1;
   private Microsoft.Office.Tools.CustomTaskPane taskPaneValue;
   

   VB

   Private taskPaneControl1 As TaskPaneControl
   Private WithEvents taskPaneValue As Microsoft.Office.Tools.CustomTaskPane
   

4. Ganti penanganan ThisAddIn_Startup aktivitas dengan kode berikut. Kode ini menambahkan TaskPaneControl objek ke CustomTaskPanes bidang, tetapi tidak menampilkan panel tugas kustom (secara default, Visible properti CustomTaskPane kelas salah). Kode Visual C# juga melampirkan penanganan aktivitas ke VisibleChanged peristiwa.

   C#

   private void ThisAddIn_Startup(object sender, System.EventArgs e)
   {
       taskPaneControl1 = new TaskPaneControl();
       taskPaneValue = this.CustomTaskPanes.Add(
           taskPaneControl1, "MyCustomTaskPane");
       taskPaneValue.VisibleChanged +=
           new EventHandler(taskPaneValue_VisibleChanged);
   }
   

   VB

   Private Sub ThisAddIn_Startup(ByVal sender As Object, _
       ByVal e As System.EventArgs) Handles Me.Startup
   
       taskPaneControl1 = New TaskPaneControl()
       taskPaneValue = Me.CustomTaskPanes.Add( _
           taskPaneControl1, "MyCustomTaskPane")
   End Sub
   

5. Tambahkan metode berikut ke kelas ThisAddIn. Metode ini menangani VisibleChanged peristiwa. Saat pengguna menutup panel tugas dengan mengklik tombol Tutup (X), metode ini memperbarui status tombol alih pada Pita.

   C#

   private void taskPaneValue_VisibleChanged(object sender, System.EventArgs e)
   {
       Globals.Ribbons.ManageTaskPaneRibbon.toggleButton1.Checked = 
           taskPaneValue.Visible;
   }
   

   VB

   Private Sub taskPaneValue_VisibleChanged(ByVal sender As Object, _
       ByVal e As System.EventArgs) Handles taskPaneValue.VisibleChanged
   
       Globals.Ribbons.ManageTaskPaneRibbon.ToggleButton1.Checked = taskPaneValue.Visible
   End Sub
   

6. Tambahkan properti berikut ke ThisAddIn kelas . Properti ini mengekspos objek privat taskPaneValue ke kelas lain. Nantinya dalam panduan ini, Anda akan menambahkan kode ke MyRibbon kelas yang menggunakan properti ini.

   C#

   public Microsoft.Office.Tools.CustomTaskPane TaskPane
   {
       get
       {
           return taskPaneValue;
       }
   }
   

   VB

   Public ReadOnly Property TaskPane() As Microsoft.Office.Tools.CustomTaskPane
       Get
           Return taskPaneValue
       End Get
   End Property
   

Sembunyikan dan perlihatkan panel tugas kustom dengan menggunakan tombol alih

Langkah terakhir adalah menambahkan kode yang menampilkan atau menyembunyikan panel tugas kustom saat pengguna mengklik tombol alih pada Pita.

Untuk menampilkan dan menyembunyikan panel tugas kustom dengan menggunakan tombol alihkan

1. Di Perancang Pita, klik ganda tombol Perlihatkan tombol alih Panel Tugas.

   Visual Studio secara otomatis menghasilkan penanganan aktivitas bernama toggleButton1_Click, yang menangani Click peristiwa tombol pengalih. Visual Studio juga membuka file MyRibbon.cs atau MyRibbon.vb di Editor Kode.

2. Ganti penanganan toggleButton1_Click aktivitas dengan kode berikut. Saat pengguna mengklik tombol alih, kode ini menampilkan atau menyembunyikan panel tugas kustom, bergantung pada apakah tombol alih ditekan atau tidak ditekan.

   C#

   private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
   {
       Globals.ThisAddIn.TaskPane.Visible = ((RibbonToggleButton)sender).Checked;
   }
   

   VB

   Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles ToggleButton1.Click
   
       Globals.ThisAddIn.TaskPane.Visible = _
           TryCast(sender, Microsoft.Office.Tools.Ribbon.RibbonToggleButton).Checked
   End Sub
   

Menguji Add-in

Saat Anda menjalankan proyek, Excel terbuka tanpa menampilkan panel tugas kustom. Klik tombol alih pada pita untuk menguji kode.

Untuk menguji Add-in VSTO Anda

1. Tekan F5 untuk menjalankan proyek Anda.

   Konfirmasikan bahwa Excel terbuka, dan tab Add-In muncul di pita.

2. Klik tab Add-In pada pita.

3. Di grup Pengelola Panel Tugas, klik tombol Perlihatkan pengalih Panel Tugas.

   Verifikasi bahwa panel tugas ditampilkan dan disembunyikan secara bergantian saat Anda mengklik tombol alih.

4. Saat panel tugas terlihat, klik tombol Tutup (X) di sudut panel tugas.

   Verifikasi bahwa tombol alih tampaknya tidak ditekan.

Langkah berikutnya

Anda bisa mempelajari selengkapnya tentang cara membuat panel tugas kustom dari topik ini:

• Buat panel tugas kustom di Add-in VSTO untuk aplikasi lain. Untuk informasi selengkapnya tentang aplikasi yang mendukung panel tugas kustom, lihat Panel tugas kustom.

• Mengotomatiskan aplikasi dari panel tugas kustom. Untuk informasi selengkapnya, lihat Panduan: Mengotomatiskan aplikasi dari panel tugas kustom.

• Buat panel tugas kustom untuk setiap pesan email yang dibuka di Outlook. Untuk informasi selengkapnya, lihat Panduan: Menampilkan panel tugas kustom dengan pesan email di Outlook.

Konten terkait

• Panel tugas kustom
• Cara: Menambahkan panel tugas kustom ke aplikasi
• Panduan: Mengotomatiskan aplikasi dari panel tugas kustom
• Panduan: Menampilkan panel tugas kustom dengan pesan email di Outlook
• Gambaran umum pita