Bagikan melalui

Menambahkan kontrol Formulir Windows ke dokumen Office

  • Artikel

Anda bisa menambahkan kontrol Formulir Windows ke dokumen Microsoft Office Excel dan Microsoft Office Word pada waktu desain dalam proyek tingkat dokumen. Pada waktu proses, Anda dapat menambahkan kontrol dalam kustomisasi tingkat dokumen dan di Add-in VSTO. Misalnya, Anda bisa menambahkan ComboBox kontrol ke lembar kerja Anda sehingga pengguna bisa memilih dari daftar opsi.

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.

Topik ini menjelaskan tugas-tugas berikut:

Menambahkan kontrol pada waktu desain

Ada beberapa cara untuk menambahkan kontrol Formulir Windows ke dokumen dalam proyek tingkat dokumen pada waktu desain.

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.

Untuk menyeret kontrol Formulir Windows ke dokumen

  1. Buat atau buka proyek Buku Kerja Excel atau proyek Dokumen Word di Visual Studio sehingga dokumen terlihat di perancang. Untuk informasi tentang membuat proyek, lihat Cara: Membuat proyek Office di Visual Studio.

  2. Di tab Kontrol Umum kotak Alat, klik kontrol yang ingin Anda tambahkan, dan seret ke dokumen.

    Catatan

    Saat Anda memilih kontrol di Excel, Anda akan melihat =EMBED("WinForms.Control.Host","") di Bilah Rumus. Teks ini diperlukan dan tidak boleh dihapus.

Untuk menggambar kontrol Formulir Windows pada dokumen

  1. Buat atau buka proyek Buku Kerja Excel atau proyek Dokumen Word di Visual Studio sehingga dokumen terlihat di perancang. Untuk informasi tentang membuat proyek, lihat Cara: Membuat proyek Office di Visual Studio.

  2. Di tab Kontrol Umum kotak Alat, klik kontrol yang ingin Anda tambahkan.

  3. Pada dokumen, klik di mana Anda ingin sudut kiri atas kontrol berada, dan seret ke tempat Anda ingin sudut kanan bawah kontrol berada.

    Kontrol ditambahkan ke dokumen dengan lokasi dan ukuran yang ditentukan.

    Catatan

    Saat Anda memilih kontrol di Excel, Anda akan melihat =EMBED("WinForms.Control.Host","") di Bilah Rumus. Teks ini diperlukan dan tidak boleh dihapus.

Untuk menambahkan kontrol Formulir Windows ke dokumen dengan mengklik satu kontrol

  1. Buat atau buka proyek Buku Kerja Excel atau proyek Dokumen Word di Visual Studio sehingga dokumen terlihat di perancang. Untuk informasi tentang membuat proyek, lihat Cara: Membuat proyek Office di Visual Studio.

  2. Di tab Kontrol Umum kotak Alat, klik kontrol yang ingin Anda tambahkan

  3. Satu dokumen, klik di mana Anda ingin kontrol ditambahkan.

    Kontrol ditambahkan ke dokumen dengan ukuran default.

    Catatan

    Saat Anda memilih kontrol di Excel, Anda akan melihat =EMBED("WinForms.Control.Host","") di Bilah Rumus. Teks ini diperlukan dan tidak boleh dihapus.

Untuk menambahkan kontrol Formulir Windows ke dokumen dengan mengklik dua kali kontrol

  1. Buat atau buka proyek Buku Kerja Excel atau proyek Dokumen Word di Visual Studio sehingga dokumen terlihat di perancang. Untuk informasi tentang membuat proyek, lihat Cara: Membuat proyek Office di Visual Studio.

  2. Di tab Kontrol Umum kotak Alat, klik dua kali kontrol yang ingin Anda tambahkan.

    Kontrol ditambahkan ke dokumen di tengah dokumen atau panel aktif.

    Catatan

    Saat Anda memilih kontrol di Excel, Anda akan melihat =EMBED("WinForms.Control.Host","") di Bilah Rumus. Teks ini diperlukan dan tidak boleh dihapus.

Untuk menambahkan kontrol Formulir Windows ke dokumen dengan menekan tombol Enter

  1. Buat atau buka proyek Buku Kerja Excel atau proyek Dokumen Word di Visual Studio sehingga dokumen terlihat di perancang. Untuk informasi tentang membuat proyek, lihat Cara: Membuat Proyek Office di Visual Studio.

  2. Di tab Kontrol Umum kotak Alat, klik kontrol yang ingin Anda tambahkan, dan tekan tombol Enter.

    Kontrol ditambahkan ke dokumen di tengah dokumen atau panel aktif.

    Catatan

    Saat Anda memilih kontrol di Excel, Anda akan melihat =EMBED("WinForms.Control.Host","") di Bilah Rumus. Teks ini diperlukan dan tidak boleh dihapus.

Menambahkan kontrol pada waktu proses dalam proyek tingkat dokumen

Anda dapat menambahkan kontrol Formulir Windows secara terprogram ke dokumen pada waktu proses. Di Word, gunakan metode Controls properti kelas ThisDocument . Di Excel, gunakan metode Controls properti kelas Sheetn . Setiap metode memiliki beberapa kelebihan beban yang memungkinkan Anda menentukan lokasi kontrol dengan cara yang berbeda.

Saat Anda menambahkan kontrol Formulir Windows ke dokumen pada waktu proses, kontrol tidak disimpan dalam dokumen saat dokumen ditutup. Anda dapat membuat ulang kontrol saat berikutnya dokumen dibuka. Untuk informasi selengkapnya, lihat Menambahkan kontrol ke dokumen Office pada waktu proses.

Untuk menambahkan kontrol Formulir Windows pada waktu proses

  1. Gunakan metode yang memiliki nama Tambahkan<kelas> kontrol (di mana kelas kontrol adalah nama kelas kontrol Formulir Windows yang ingin Anda tambahkan, seperti AddButton).

    Contoh kode berikut menunjukkan cara menambahkan Button ke sel C5 dari Sheet1 dalam proyek tingkat dokumen untuk Excel.

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button salesButton;
    salesButton = this.Controls.AddButton(this.get_Range("C5"), "salesButton");
    salesButton.Text = "Calculate Total Sales";
}

Menambahkan kontrol pada waktu proses di Add-in VSTO

Anda dapat menambahkan kontrol Formulir Windows secara terprogram ke dokumen terbuka apa pun pada waktu proses. Pertama, buat item host yang didasarkan pada dokumen atau lembar kerja yang terbuka. Kemudian, di Word, gunakan metode Controls properti item host baru. Di Excel, gunakan metode Controls properti item host baru. Setiap metode memiliki beberapa kelebihan beban yang memungkinkan Anda menentukan lokasi kontrol dengan cara yang berbeda.

Saat Anda menambahkan kontrol Formulir Windows ke dokumen pada waktu proses, kontrol tidak disimpan dalam dokumen saat dokumen ditutup. Anda dapat membuat ulang kontrol saat berikutnya dokumen dibuka. Untuk informasi selengkapnya, lihat Menambahkan kontrol ke dokumen Office pada waktu proses.

Untuk informasi selengkapnya tentang membuat item host di proyek Add-in VSTO, lihat Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses.

Untuk menambahkan kontrol Formulir Windows pada waktu proses

  1. Gunakan metode yang memiliki nama Tambahkan<kelas> kontrol (di mana kelas kontrol adalah nama kelas kontrol Formulir Windows yang ingin Anda tambahkan, seperti AddButton).

    Catatan

    Dalam proyek Add-in VSTO yang menargetkan .NET Framework 4 atau yang lebih baru, Anda harus menambahkan referensi ke rakitan Microsoft.Office.Tools.Excel.v4.0.Utilities.dll atau Microsoft.Office.Tools.Word.v4.0.Utilities.dll sebelum Anda bisa mengakses metode Tambahkan<kelas> kontrol.

    Contoh kode berikut menunjukkan cara menambahkan Button ke paragraf pertama dokumen aktif dengan menggunakan Add-in Word VSTO.

    Microsoft.Office.Tools.Word.Controls.Button salesButton;

Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);


extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
salesButton = extendedDocument.Controls.AddButton(
    extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
salesButton.Text = "Calculate Sales";

Konten terkait