Bagikan melalui

Panduan: Mengumpulkan data dengan menggunakan Formulir Windows

  • Artikel

Panduan ini menunjukkan cara membuka Formulir Windows dari kustomisasi tingkat dokumen untuk Microsoft Office Excel, mengumpulkan informasi dari pengguna, dan menulis informasi tersebut ke dalam sel lembar kerja.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO. Lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Meskipun panduan ini menggunakan proyek tingkat dokumen untuk Excel secara khusus, konsep yang ditunjukkan oleh panduan ini berlaku untuk proyek Office lainnya.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

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.

Membuat proyek baru

Langkah pertama adalah membuat proyek Buku Kerja Excel.

Untuk membuat proyek baru

  1. Buat proyek Buku Kerja Excel dengan nama WinFormInput, dan pilih Buat dokumen baru di wizard. Untuk informasi selengkapnya, lihat Cara: membuat proyek Office di Visual Studio.

    Visual Studio membuka buku kerja Excel baru di perancang dan menambahkan proyek WinFormInput ke Penjelajah Solusi.

Menambahkan kontrol NamedRange ke lembar kerja

Untuk menambahkan rentang bernama ke Sheet1

  1. Pilih sel A1 di Sheet1.

  2. Dalam kotak Nama , ketik formInput.

    Kotak Nama terletak di sebelah kiri bilah rumus, tepat di atas kolom A lembar kerja.

  3. Tekan Enter.

    NamedRange Kontrol ditambahkan ke sel A1. Tidak ada indikasi yang terlihat pada lembar kerja, tetapi formInput muncul di kotak Nama (tepat di atas lembar kerja di sisi kiri) dan di jendela Properti saat sel A1 dipilih.

Menambahkan Formulir Windows ke proyek

Buat Formulir Windows untuk meminta informasi kepada pengguna.

Untuk menambahkan Formulir Windows

  1. Pilih proyek WinFormInput di Penjelajah Solusi.

  2. Pada menu Proyek , klik Tambahkan Formulir Windows.

  3. Beri nama formulir GetInputString.vb atau GetInputString.cs, lalu klik Tambahkan.

    Formulir baru terbuka di perancang.

  4. TextBox Tambahkan dan Button ke formulir.

  5. Pilih tombol , temukan properti Teks di jendela Properti , dan ubah teks menjadi OK.

    Selanjutnya, tambahkan kode ke ThisWorkbook.vb atau ThisWorkbook.cs untuk mengumpulkan informasi pengguna.

Menampilkan Formulir Windows dan mengumpulkan informasi

Buat instans GetInputString Formulir Windows dan tampilkan, lalu tulis informasi pengguna ke dalam sel di lembar kerja.

Untuk menampilkan formulir dan mengumpulkan informasi

  1. Klik kanan ThisWorkbook.vb atau ThisWorkbook.cs di Penjelajah Solusi, lalu klik Tampilkan Kode.

  2. Di penanganan OpenThisWorkbookaktivitas , tambahkan kode berikut untuk mendeklarasikan variabel untuk formulir GetInputString lalu tampilkan formulir.

    Catatan

    Di C#, Anda harus menambahkan penanganan aktivitas seperti yang ditunjukkan pada peristiwa di Startup bawah ini. Untuk informasi tentang membuat penanganan aktivitas, lihat Cara: Membuat penanganan aktivitas di proyek Office.

    private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
    this.Open += new 
        Microsoft.Office.Interop.Excel.WorkbookEvents_OpenEventHandler(ThisWorkbook_Open);
}

private void ThisWorkbook_Open()
{
    GetInputString inputForm = new GetInputString();
    inputForm.ShowDialog();
}

  3. Buat metode yang disebut WriteStringToCell yang menulis teks ke rentang bernama. Metode ini dipanggil dari formulir, dan input pengguna diteruskan ke NamedRange kontrol, formInput, pada sel A1.

    public void WriteStringToCell(string formData)
{
    Globals.Sheet1.formInput.Value2 = formData;
}

    Selanjutnya, tambahkan kode ke formulir untuk menangani peristiwa klik tombol.

Mengirim informasi ke lembar kerja

Untuk mengirim informasi ke lembar kerja

  1. Klik kanan GetInputString di Penjelajah Solusi, lalu klik Tampilkan Perancang.

  2. Klik dua kali tombol untuk membuka file kode dengan penanganan aktivitas tombol Click ditambahkan.

  3. Tambahkan kode ke penanganan aktivitas untuk mengambil input dari kotak teks, mengirimnya ke fungsi WriteStringToCell, lalu tutup formulir.

    Globals.ThisWorkbook.WriteStringToCell(this.textBox1.Text);
this.Dispose();

Uji

Anda sekarang dapat menjalankan proyek. Formulir Windows muncul, dan input Anda muncul di lembar kerja.

Untuk menguji buku kerja Anda

  1. Tekan F5 untuk menjalankan proyek Anda.

  2. Konfirmasikan bahwa Formulir Windows muncul.

  3. Ketik Halo Dunia dalam kotak teks, lalu klik OK.

  4. Konfirmasikan bahwa Halo Dunia muncul di sel A1 lembar kerja.

Langkah berikutnya

Panduan ini memperlihatkan dasar-dasar memperlihatkan Formulir Windows dan meneruskan data ke lembar kerja. Tugas lain yang mungkin ingin Anda lakukan meliputi:

  • Gunakan kontrol Formulir Windows pada buku kerja Excel atau dokumen Word. Untuk informasi selengkapnya, lihat Formulir Windows kontrol pada gambaran umum dokumen Office.

  • Ubah antarmuka pengguna Microsoft aplikasi Office lication dari kustomisasi tingkat dokumen atau Add-in VSTO. Untuk informasi selengkapnya, lihat Kustomisasi Office UI.

Konten terkait