Bagikan melalui

Gambaran umum panel Tindakan

Penting

Fitur Actions telah dihentikan dari Microsoft Word mulai Office 2024. Fitur ini hanya tersedia di Microsoft Word dengan rilis Office berikut ini:

  • Microsoft 365
  • Office LTSC Professional Plus 2021
  • Standar LTSC Kantor 2021
  • Office Professional Plus 2016, 2019
  • Standar Kantor 2016, 2019

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 Windows Forms 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 oleh aplikasi Office 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 oleh aplikasi Office dan jenis proyek.

Nota

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 Microsoft Office. 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 Windows Forms ke properti Controls dari bidang ActionsPane. Contoh kode berikut menambahkan kontrol bernama actions ke panel tindakan.

this.ActionsPane.Controls.Add(actions);

Panel tindakan terlihat saat dijalankan segera setelah Anda secara eksplisit menambahkan kontrol ke sana. 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 event Click dari kontrol di 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 menyertakan kelas Windows Forms UserControl kustom. Item Kontrol Panel Tindakan dan Kontrol Pengguna setara; satu-satunya perbedaan adalah nama mereka.

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

    Nota

    Anda juga dapat menambahkan kontrol WPF ke panel tindakan dengan menambahkan WPF UserControl ke Formulir UserControl Windows. 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

Meskipun ActionsPane kelas memiliki Hide metode dan Visible properti, Anda tidak dapat menghapus panel tindakan dari antarmuka pengguna dengan menggunakan anggota ActionsPane kelas 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 metode Clear dari bidang ActionsPane di penangan kejadian Startup dari ThisDocument atau ThisWorkbook agar panel tindakan tidak terlihat ketika dokumen dibuka.

Menentukan kapan panel tindakan ditutup

Tidak ada peristiwa yang dimunculkan saat panel tindakan ditutup. Meskipun kelas memiliki peristiwa ActionsPane, peristiwa ini tidak dipicu saat pengguna akhir menutup panel tindakan. Sebaliknya, peristiwa ini dipicu ketika elemen kontrol pada panel tindakan disembunyikan dengan memanggil metode Hide atau dengan mengatur properti Visible 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 .

Acara jendela 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 Langkah-langkah: Program terhadap kejadian pada 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 data dan Formulir Windows.

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 menyusun kontrol pengguna dengan benar pada panel tindakan, baik itu diposisikan secara vertikal atau horizontal. Anda dapat mengatur tumpukan urutan kontrol pengguna pada panel tindakan dengan menggunakan StackStyle enumerasi dari 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
DariBawah Susun dari bagian bawah panel tindakan.
DariKiri Tumpukan dari kiri panel tindakan.
Dari Kanan Tumpukan dari kanan panel tindakan.
Dari Atas Susun dari bagian atas panel tindakan.
Tidak ada 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 saat runtime, kontrol dapat mengubah ukuran dengan panel tindakan. Anda dapat menggunakan properti Anchor dari kontrol Formulir Windows untuk menjangkar kontrol ke panel tugas. Anda juga dapat menjangkar kontrol Windows Forms 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 ActionsPane karena ActionsPane disematkan di panel tugas. Namun, Anda dapat mengubah lebar panel tugas melalui pemrograman dengan mengatur properti Width dari CommandBar yang mewakili panel tugas. Anda bisa mengubah tinggi panel tugas jika terpasang 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 programatik dengan mengatur properti Position dari 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;

Nota

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

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

Jika panel tugas tidak ditampung, Anda bisa mengatur Top dan Left properti dari CommandBar yang mewakili panel tugas. Kode berikut memindahkan panel tugas yang mengambang 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