Bagikan melalui

Gambaran umum panel Tindakan

  • Artikel

Panel tindakan adalah panel tugas Tindakan Dokumen yang dapat disesuaikan yang dilampirkan ke dokumen Microsoft Office Word tertentu atau buku kerja Microsoft Office Excel. Panel tindakan dihosting di dalam panel tugas Office bersama dengan panel tugas bawaan lainnya, seperti panel tugas Sumber XML di Excel atau panel tugas Gaya dan Pemformatan di Word. Anda dapat menggunakan kontrol Formulir Windows atau kontrol WPF untuk merancang antarmuka pengguna panel tindakan.

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

Anda bisa membuat panel tindakan hanya dalam kustomisasi tingkat dokumen untuk Word atau Excel. Anda tidak dapat membuat panel tindakan di Add-in VSTO. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Catatan

Panel tindakan berbeda dari panel tugas kustom. Panel tugas kustom dikaitkan dengan aplikasi, bukan dokumen tertentu. Anda dapat membuat panel tugas kustom di Add-in VSTO untuk beberapa aplikasi Office likasi Microsoft. Untuk informasi selengkapnya, lihat Panel tugas kustom.

Menampilkan panel tindakan

Panel tindakan diwakili oleh ActionsPane kelas . Saat Anda membuat proyek tingkat dokumen, instans kelas ini tersedia untuk kode Anda dengan menggunakan ActionsPane bidang ThisWorkbook kelas (untuk Excel) atau ThisDocument (untuk Word) di proyek Anda. Untuk menampilkan panel tindakan, tambahkan kontrol Formulir Windows ke Controls properti ActionsPane bidang . Contoh kode berikut menambahkan kontrol bernama actions ke panel tindakan.

this.ActionsPane.Controls.Add(actions);

Panel tindakan menjadi terlihat pada waktu proses segera setelah Anda secara eksplisit menambahkan kontrol ke dalamnya. Setelah panel tindakan ditampilkan, Anda dapat menambahkan atau menghapus kontrol secara dinamis sebagai respons terhadap tindakan pengguna. Biasanya, Anda menambahkan kode untuk menampilkan panel tindakan di Startup penanganan aktivitas atau ThisDocumentThisWorkbook sehingga panel tindakan terlihat saat pengguna pertama kali membuka dokumen. Namun, Anda mungkin ingin menampilkan panel tindakan hanya sebagai respons terhadap tindakan pengguna dalam dokumen. Misalnya, Anda dapat menambahkan kode ke Click peristiwa kontrol pada dokumen.

Menambahkan beberapa kontrol ke panel tindakan

Saat menambahkan beberapa kontrol ke panel tindakan, Anda harus mengelompokkan kontrol dalam kontrol pengguna lalu menambahkan kontrol pengguna ke Controls properti . Proses ini mencakup langkah-langkah berikut:

  1. Buat antarmuka pengguna (UI) panel tindakan dengan menambahkan item Kontrol Panel Tindakan atau Kontrol Pengguna ke proyek Anda. Kedua item ini mencakup kelas Formulir Windows UserControl kustom. Item Kontrol Panel Tindakan dan Kontrol Pengguna setara; satu-satunya perbedaan adalah namanya.

  2. Tambahkan kontrol Formulir Windows dengan UserControl menggunakan perancang, atau dengan menulis kode.

    Catatan

    Anda juga dapat menambahkan kontrol WPF ke panel tindakan dengan menambahkan WPF UserControl ke Formulir Windows UserControl. Untuk informasi selengkapnya, lihat Menggunakan kontrol WPF di solusi Office.

  3. Tambahkan instans kontrol pengguna kustom ke kontrol yang terdapat di ActionsPane bidang ThisWorkbook kelas (untuk Excel) atau ThisDocument (untuk Word) di proyek Anda.

    Untuk contoh yang menunjukkan proses ini secara lebih rinci, lihat Cara: Menambahkan panel tindakan ke dokumen Word atau buku kerja Excel.

Menyembunyikan panel tindakan

ActionsPane Meskipun kelas memiliki Hide metode dan Visible properti, Anda tidak dapat menghapus panel tindakan dari antarmuka pengguna dengan menggunakan anggota kelas itu ActionsPane sendiri. Memanggil Hide metode atau mengatur Visible properti ke false hanya menyembunyikan kontrol pada panel tindakan; tidak menyembunyikan panel tugas.

Untuk menyembunyikan panel tugas dalam solusi Anda, Anda memiliki beberapa opsi:

  • Untuk Word, atur Visible properti TaskPane objek yang mewakili panel tugas Tindakan Dokumen ke false. Contoh kode berikut dimaksudkan untuk dijalankan dari ThisDocument kelas di proyek Anda.

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;

  • Untuk Excel, atur DisplayDocumentActionTaskPane properti objek ke Applicationfalse. Contoh kode berikut dimaksudkan untuk dijalankan dari ThisWorkbook kelas di proyek Anda.

    this.Application.DisplayDocumentActionTaskPane = false;

  • Untuk Word atau Excel, Anda bisa mengatur Visible properti bilah perintah yang mewakili panel tugas ke false. Contoh kode berikut dimaksudkan untuk dijalankan dari ThisDocument kelas atau ThisWorkbook dalam proyek Anda.

    this.Application.CommandBars["Task Pane"].Visible = false;

Bersihkan panel tindakan saat dokumen dibuka

Saat pengguna menyimpan dokumen saat panel tindakan terlihat, panel tindakan terlihat setiap kali dokumen dibuka, apakah panel tindakan berisi kontrol apa pun atau tidak. Jika Anda ingin mengontrol kapan munculnya, panggil Clear metode ActionsPane bidang di Startup penanganan ThisDocument aktivitas atau ThisWorkbook untuk memastikan bahwa panel tindakan tidak terlihat saat dokumen dibuka.

Menentukan kapan panel tindakan ditutup

Tidak ada peristiwa yang dimunculkan saat panel tindakan ditutup. ActionsPane Meskipun kelas memiliki VisibleChanged peristiwa, peristiwa ini tidak dinaikkan saat pengguna akhir menutup panel tindakan. Sebagai gantinya, peristiwa ini dinaikkan ketika kontrol pada panel tindakan disembunyikan dengan memanggil Hide metode atau dengan mengatur Visible properti ke false.

Saat pengguna menutup panel tindakan, pengguna dapat menampilkannya lagi dengan melakukan salah satu prosedur berikut di antarmuka pengguna (UI) aplikasi.

Untuk menampilkan panel tindakan dengan menggunakan UI Word atau Excel

  1. Pada Pita, klik tab Tampilan .

  2. Di grup Perlihatkan/Sembunyikan, klik tombol alih Tindakan Dokumen.

Peristiwa panel tindakan program

Anda bisa menambahkan beberapa kontrol pengguna ke panel tindakan lalu menulis kode untuk merespons peristiwa pada dokumen dengan memperlihatkan dan menyembunyikan kontrol pengguna. Jika Anda memetakan elemen skema XML ke dokumen, Anda bisa menampilkan kontrol pengguna tertentu di panel tindakan setiap kali titik penyisipan berada di dalam salah satu elemen XML. Untuk informasi selengkapnya, lihat Cara: Memetakan skema ke dokumen Word di dalam Visual Studio dan Cara: Memetakan skema ke lembar kerja di dalam Visual Studio.

Anda juga dapat menulis kode untuk merespons peristiwa objek apa pun, termasuk kontrol host, aplikasi, atau peristiwa dokumen. Untuk informasi selengkapnya, lihat Panduan: Program terhadap peristiwa kontrol NamedRange.

Mengikat data ke kontrol pada panel tindakan

Kontrol pada panel tindakan memiliki kemampuan pengikatan data yang sama dengan kontrol pada Formulir Windows. Anda dapat mengikat kontrol ke sumber data seperti himpunan data, himpunan data yang diketik, dan XML. Untuk informasi selengkapnya, lihat Pengikatan dan Formulir Windows data.

Anda dapat mengikat kontrol pada panel tindakan dan kontrol pada dokumen ke himpunan data yang sama. Misalnya, Anda bisa membuat hubungan master/detail antara kontrol pada panel tindakan dan kontrol pada lembar kerja. Untuk informasi selengkapnya, lihat Panduan: Mengikat data ke kontrol pada panel tindakan Excel.

Memvalidasi data dalam kontrol panel tindakan

Jika Anda menampilkan kotak pesan di Validating penanganan aktivitas kontrol pada panel tindakan, peristiwa mungkin dinaikkan untuk kedua kalinya saat fokus berpindah dari kontrol ke kotak pesan. Untuk mencegah masalah ini, gunakan ErrorProvider kontrol untuk menampilkan pesan kesalahan validasi apa pun.

Urutan tumpukan kontrol pengguna

Jika Anda menggunakan beberapa kontrol pengguna, Anda dapat menulis kode untuk menumpuk kontrol pengguna dengan benar pada panel tindakan apakah itu ditampung secara vertikal atau horizontal. Anda dapat mengatur urutan penumpukan kontrol pengguna pada panel tindakan dengan menggunakan StackStyle enumerasi StackOrder properti. Untuk informasi selengkapnya, lihat Cara: Mengelola tata letak kontrol pada panel tindakan.

Properti StackOrder dapat mengambil nilai enumerasi berikut StackStyle .

Gaya tumpukan Definisi
FromBottom Tumpukan dari bagian bawah panel tindakan.
FromLeft Tumpukan dari kiri panel tindakan.
FromRight Tumpukan dari kanan panel tindakan.
Dari Atas Tumpukan dari bagian atas panel tindakan.
Tidak Tidak ada urutan tumpukan yang ditentukan; urutan dikendalikan oleh pengembang.

Kode berikut mengatur StackOrder properti untuk menumpuk kontrol pengguna dari bagian atas panel tindakan.

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

Kontrol jangkar

Jika pengguna mengubah ukuran panel tindakan pada run time, kontrol dapat mengubah ukuran dengan panel tindakan. Anda bisa menggunakan Anchor properti kontrol Formulir Windows untuk jangkar kontrol ke panel tindakan. Anda juga dapat menjangkar kontrol Formulir Windows ke kontrol pengguna dengan cara yang sama. Untuk informasi selengkapnya, lihat Cara: Kontrol jangkar pada Formulir Windows.

Mengubah ukuran panel tindakan

Anda tidak dapat langsung mengubah ukuran karena ActionsPaneActionsPane disematkan di panel tugas. Namun, Anda dapat mengubah lebar panel tugas secara terprogram dengan mengatur Width properti CommandBar yang mewakili panel tugas. Anda bisa mengubah tinggi panel tugas jika ditampung secara horizontal atau mengambang.

Mengubah ukuran panel tugas secara terprogram tidak disarankan karena pengguna harus dapat memilih ukuran panel tugas yang paling sesuai dengan kebutuhan mereka. Namun, jika Anda harus mengubah ukuran lebar panel tugas, Anda bisa menggunakan kode berikut untuk mencapai tugas ini.

this.CommandBars["Task Pane"].Width = 200;

Memposisikan ulang panel tindakan

Anda tidak dapat langsung memposisikan ActionsPane ulang karena disematkan di panel tugas. Namun, Anda dapat memindahkan panel tugas secara terprogram dengan mengatur Position properti CommandBar yang mewakili panel tugas.

Memposisikan ulang panel tugas secara terprogram tidak disarankan karena pengguna harus dapat memilih posisi panel tugas di layar yang paling sesuai dengan kebutuhannya. Namun, jika Anda harus memindahkan panel tugas ke posisi tertentu, Anda bisa menggunakan kode berikut untuk mencapai tugas ini.

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

Catatan

Pengguna akhir dapat memposisikan ulang panel tugas secara manual kapan saja. Tidak ada cara untuk memastikan bahwa panel tugas akan tetap ditampar pada posisi yang Anda tunjukkan secara terprogram. Namun, Anda dapat memeriksa perubahan orientasi dan memastikan bahwa kontrol pada panel tindakan ditumpuk ke arah yang benar. Untuk informasi selengkapnya, lihat Cara: Mengelola tata letak kontrol pada panel tindakan.

Top Mengatur properti ActionsPane dan Left tidak mengubah posisinya karena ActionsPane objek disematkan di panel tugas.

Jika panel tugas tidak ditampung, Anda bisa mengatur Top properti CommandBar dan Left yang mewakili panel tugas. Kode berikut memindahkan panel tugas yang tidak ditautkan ke sudut kiri atas dokumen.

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}

Konten terkait