Bagikan melalui

Batasan kontrol Formulir Windows pada dokumen Office

Ada beberapa perbedaan antara kontrol Formulir Windows yang ditambahkan ke dokumen Microsoft Office Word atau lembar kerja Microsoft Office Excel, dan kontrol Formulir Windows yang ditambahkan ke Formulir Windows. Misalnya, saat Anda menambahkan kontrol ke dokumen, properti seperti Dock, Anchor, dan TabIndex tidak berulah seperti yang Button Anda harapkan.

Banyak dari perbedaan ini disebabkan oleh cara kontrol Formulir Windows dihosting pada dokumen. Saat kontrol Formulir Windows ditambahkan ke dokumen, runtime Visual Studio Tools for Office menyematkan kontrol ActiveX yang kemudian menghosting kontrol Formulir Windows dalam dokumen. Kontrol Formulir Windows tidak disematkan langsung dalam dokumen.

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

Batasan metode dan properti kontrol Formulir Windows

Ada sejumlah metode dan properti kontrol Formulir Windows yang tidak berfungsi dengan cara yang sama pada dokumen seperti yang mereka lakukan pada Formulir Windows dan, oleh karena itu, disarankan agar tidak digunakan. Misalnya, mengatur properti seperti Dock dan Anchor hanya memengaruhi posisi kontrol sehubungan dengan kontrol ActiveX kontainer, bukan dokumen. Berikut ini adalah daftar metode dan properti kontrol Formulir Windows yang tidak didukung untuk Word dan Excel:

Anda juga tidak dapat mengatur Left properti atau Top kontrol Formulir Windows yang sejajar dengan teks pada dokumen Word. Formulir Windows kontrol ditambahkan sejajar dengan teks dalam kasus berikut:

  • Anda secara terprogram menambahkan kontrol ke dokumen Word dan menggunakan metode yang menentukan rentang untuk lokasi tersebut.

  • Anda menambahkan kontrol Formulir Windows ke dokumen Word pada waktu desain. Anda dapat mengubah ini dengan memodifikasi kontrol di perancang.

Perbedaan kontrol Formulir Windows pada dokumen Office

Formulir Windows kontrol umumnya memiliki perilaku yang sama pada dokumen Office seperti yang mereka lakukan pada Formulir Windows, tetapi beberapa perbedaan memang ada. Tabel berikut ini menjelaskan perbedaan yang ada untuk kontrol Formulir Windows pada dokumen Office.

Fungsi Perbedaan
Urutan tab kontrol Anda tidak dapat menelusuri kontrol yang ditempatkan pada lembar kerja Excel atau dokumen Word.
Mengontrol pengelompokan Anda tidak dapat menggunakan GroupBox kontrol untuk memuat kontrol lain pada dokumen Office. Saat Anda menambahkan beberapa tombol radio langsung ke dokumen, tombol radio tidak saling eksklusif. Anda dapat menulis kode untuk membuat tombol radio saling eksklusif; namun, pendekatan yang disukai adalah menambahkan tombol radio ke kontrol pengguna lalu menambahkan kontrol pengguna ke dokumen. Untuk informasi selengkapnya, lihat Sampel Kontrol Word atau Sampel Kontrol Excel di sampel dan panduan pengembangan Office.
Jenis kontrol Formulir Windows kontrol yang digunakan pada dokumen dibungkus dalam kelas yang disediakan oleh runtime Visual Studio Tools for Office yang memberikan kontrol fungsionalitas tambahan khusus untuk lembar kerja Excel atau dokumen Word. Misalnya, jika Anda memiliki kontrol Tombol pada lembar kerja Excel, pastikan untuk menentukan tipe sebagai Button daripada Button saat merujuk atau mentransmisikan objek.
Posisi dan ukuran kontrol Ukuran dan posisi kontrol ditentukan oleh properti yang merupakan bagian dari kontrol ActiveX kontainer. Properti kontrol ActiveX mengambil nilai yang berbeda dari properti kontrol Formulir Windows yang setara. Saat Anda mengatur Topproperti , Left, Height, atau Width kontrol, itu diukur dalam poin, bukan piksel.
Mengontrol posisi pada dokumen Word Jika Anda menambahkan kontrol ke tata letak berbasis alur, perlu diingat bahwa kontrol akan mengalir dengan konten saat konten berubah. Anda tidak dapat menjangkar kontrol ke paragraf saat Anda menyeretnya dari Kotak Alat karena kontrol ditambahkan ke dokumen Word sejajar dengan teks. Jika Anda menggunakan metode lain untuk menambahkan kontrol, seperti mengklik dua kali kontrol, kontrol disisipkan sesuai dengan opsi Word yang telah Anda atur untuk menyisipkan gambar.

Anda tidak dapat mengatur Left properti atau Top kontrol yang sebaris dengan teks.

Anda tidak dapat menempatkan kontrol di header atau footer, atau dalam subdokumen.
Mengontrol peristiwa Saat kontrol dipilih, kontrol akan memunculkan peristiwa dalam urutan berikut:

1. Enter
2. GotFocus

Saat kontrol tidak dipilih, kontrol akan memunculkan peristiwa dalam urutan berikut:

1. Leave
2. Validating
3. Validated
4. LostFocus
Penskalakan kontrol Saat Anda mengubah pengaturan zoom dokumen ke apa pun selain 100%, kontrol dinonaktifkan, meskipun terlihat menskalakan dengan dokumen. Misalnya, jika Anda mengklik tombol saat dokumen Anda berada di zoom 130%, itu akan menampilkan pesan bahwa kontrol telah dinonaktifkan hingga zoom diatur ke 100%. Kontrol akan berfungsi dengan benar ketika Anda mengubah zoom menjadi 100%.
Mengontrol nilai properti Meskipun properti kontrol pada Formulir Windows diatur ke nilai bilangan bulat, properti tersebut diatur ke satu untuk kontrol pada dokumen Word. Di Excel, nilai properti kontrol diatur ke ganda. Height Jika properti dan Width kontrol pada lembar kerja melebihi ukuran lembar kerja atau layar, nilai terpotong.
Mengubah ukuran kontrol Jika Anda mengubah ukuran kontrol pada dokumen menggunakan salah satu dari delapan handel ukuran, dimensi kontrol baru tidak tercermin di jendela Properti hingga kontrol dipilih kembali.
Perilaku kontrol Kontrol pada lembar kerja Excel mungkin bertingkah tidak terduga ketika jendela lembar kerja dipisahkan. Misalnya, akses ke TextBox lembar kerja mungkin hanya tersedia di salah satu jendela.
Penamaan kontrol Anda tidak dapat menggunakan kata yang dicadangkan untuk kontrol nama. Misalnya, jika Anda menambahkan Button ke lembar kerja dan mengubah nama menjadi Sistem, kesalahan terjadi saat Anda membuat proyek.
Menambahkan kontrol secara terprogram Jangan gunakan konstruktor kontrol untuk menambahkan kontrol ke dokumen Anda pada waktu proses. Sebagai gantinya, gunakan metode pembantu yang disediakan oleh Visual Studio Tools untuk runtime Office . Misalnya, gunakan AddButton metode untuk menambahkan tombol ke lembar kerja. Jika Anda ingin menambahkan kontrol yang tidak didukung oleh metode pembantu ini, Anda dapat menggunakan metode .AddControl Untuk informasi selengkapnya, lihat Menambahkan kontrol ke dokumen Office pada waktu proses.
Menyalin kontrol Jika Anda menyalin kontrol Formulir Windows dan menempelkannya ke dokumen pada waktu proses, kontrol ActiveX kontainer kosong ditempelkan ke dalam dokumen. Kontrol Formulir Windows tidak muncul di lokasi baru, dan kode di belakang kontrol asli tidak disalin ke kontrol ActiveX kontainer.

Batasan dalam proyek tingkat dokumen

Beberapa batasan penggunaan kontrol Formulir Windows pada dokumen bersifat unik untuk proyek tingkat dokumen.

Mengontrol dukungan pada waktu desain

Kontrol Formulir Windows tertentu dihapus dari Kotak Alat saat lembar kerja Excel atau dokumen Word terbuka di desainer Visual Studio. Ini karena keterbatasan teknis atau karena fungsionalitas sudah tersedia dalam Word atau Excel. Proyek Excel dan Word mendukung semua kontrol Formulir Windows dan komponen lain yang muncul di Kotak Alat saat dokumen memiliki fokus, dan Anda juga bisa menambahkan kontrol pihak ketiga ke lembar kerja atau dokumen.

Catatan

Semua kontrol dihapus dari Kotak Alat saat dokumen dilindungi. Untuk informasi tentang perlindungan dokumen, lihat Perlindungan dokumen dalam solusi tingkat dokumen.

Catatan

Kontrol pihak ketiga harus memiliki atribut yang ComVisibleAttribute diatur ke true agar dapat digunakan dalam solusi Office.

Kontrol dan komponen berikut ini tidak tersedia di Kotak Alat:

Dukungan untuk kontrol ActiveX warisan

Jika Anda membuat proyek Office tingkat dokumen yang menggunakan dokumen Word atau buku kerja Excel yang sudah ada yang berisi kontrol ActiveX, fungsionalitas kontrol ActiveX tidak hilang; namun, tidak ada dukungan untuk menambahkan kontrol ActiveX baru ke dokumen Anda dari dalam Visual Studio. Misalnya, jika dokumen Word Anda memiliki tombol dari kotak alat Kontrol yang menjalankan makro Visual Basic for Applications (VBA), dokumen akan terus menjalankan makro setelah dokumen digunakan dalam proyek Office. Namun, disarankan agar Anda menghapus kontrol ActiveX dan makro VBA dan menggantinya dengan kontrol Formulir Windows dan kode terkelola.

Konten terkait