Menambahkan Kontrol (Tutorial ATL, Bagian 2)

Dalam langkah ini, Anda menambahkan kontrol ke proyek Anda, membangunnya, dan mengujinya di halaman Web.

Prosedur

Untuk menambahkan objek ke proyek ATL

1. Di Penjelajah Solusi, klik Polygon kanan proyek.

2. Arahkan ke Tambahkan pada menu pintasan, dan klik Item Baru di submenu.

   Kotak dialog Tambahkan Item Baru akan muncul. Kategori objek yang berbeda tercantum dalam struktur pohon di sebelah kiri.

3. Klik folder ATL.

4. Dari daftar templat di sebelah kanan, pilih Kontrol ATL. Klik Tambahkan. Wizard Kontrol ATL akan terbuka, dan Anda dapat mengonfigurasi kontrol.

5. Ketik PolyCtl sebagai nama pendek dan perhatikan bahwa bidang lain secara otomatis selesai. Jangan klik Selesai , karena Anda harus membuat beberapa perubahan lagi.

Halaman Nama wizard Kontrol ATL berisi bidang berikut ini:

Bidang	Konten
Nama pendek	Nama yang Anda masukkan untuk kontrol.
Kelas	Nama kelas C++ yang dibuat untuk mengimplementasikan kontrol.
File .h	File yang dibuat untuk berisi definisi kelas C++.
file .cpp	File yang dibuat untuk berisi implementasi kelas C++.
CoClass	Nama kelas komponen untuk kontrol ini.
Antarmuka	Nama antarmuka tempat kontrol akan mengimplementasikan metode dan properti kustomnya.
Jenis	Deskripsi untuk kontrol.
ProgID	Nama yang dapat dibaca yang dapat digunakan untuk mencari CLSID kontrol.

Anda akan menemukan beberapa pengaturan tambahan harus diubah di wizard Kontrol ATL.

Untuk mengaktifkan dukungan untuk informasi kesalahan yang kaya dan titik koneksi

1. Klik Opsi untuk membuka halaman Opsi .

2. Pilih kotak centang Titik koneksi. Opsi ini membuat dukungan untuk antarmuka keluar dalam file IDL.

Anda juga dapat menambahkan antarmuka untuk memperluas fungsionalitas kontrol.

Untuk memperluas fungsionalitas kontrol

1. Klik Antarmuka untuk membuka halaman Antarmuka .

2. Pilih IProvideClassInfo2 dan klik panah Atas untuk memindahkannya ke daftar Didukung .

3. Pilih ISpecifyPropertyPages dan klik panah Atas untuk memindahkannya ke daftar Didukung .

Anda juga dapat membuat kontrol dapat disisipkan, yang berarti dapat disematkan ke dalam aplikasi yang mendukung objek yang disematkan, seperti Excel atau Word.

Agar kontrol dapat disisipkan

1. Klik Tampilan untuk membuka halaman Tampilan .

2. Pilih kotak centang Yang dapat disisipkan .

Poligon yang ditampilkan oleh objek akan memiliki warna isian solid, jadi Anda harus menambahkan Fill Color properti stok.

Untuk menambahkan properti stok Warna Isian dan membuat kontrol

1. Klik Properti Stok untuk membuka halaman Properti Stok.

2. Di bawah Tidak didukung, gulir ke bawah daftar properti stok yang mungkin. Pilih Fill Color dan klik panah Atas untuk memindahkannya ke daftar Didukung .

3. Pilih Selesai.

Saat wizard membuat kontrol, beberapa perubahan kode dan penambahan file terjadi. File berikut dibuat:

Arsip	Deskripsi
PolyCtl.h	Berisi sebagian besar implementasi kelas CPolyCtlC++ .
PolyCtl.cpp	Berisi bagian yang tersisa dari CPolyCtl.
PolyCtl.rgs	File teks yang berisi skrip registri yang digunakan untuk mendaftarkan kontrol.
PolyCtl.htm	Halaman Web yang berisi referensi ke kontrol yang baru dibuat.

Wizard juga membuat perubahan kode berikut:

• #include Menambahkan pernyataan ke file header yang telah dikommpilasikan untuk menyertakan file ATL yang diperlukan untuk kontrol pendukung.

• Ubah Polygon.idl untuk menyertakan detail kontrol baru.

• Menambahkan kontrol baru ke peta objek di Polygon.cpp.

Sekarang Anda dapat membangun kontrol untuk melihatnya beraksi.

Membangun dan Menguji Kontrol

Untuk membangun dan menguji kontrol

1. Pada menu Build , klik Bangun Poligon.

   Setelah kontrol selesai dibangun, klik kanan PolyCtl.htm di Penjelajah Solusi dan pilih Tampilkan di Browser. Halaman Web HTML yang berisi kontrol ditampilkan. Anda akan melihat halaman dengan judul "halaman uji ATL 8.0 untuk polyCtl objek", dan kontrol Anda, teks PolyCtl.

Catatan

Jika kontrol tidak terlihat, ketahuilah bahwa beberapa browser memerlukan penyesuaian pengaturan untuk menjalankan kontrol ActiveX. Lihat dokumentasi browser tentang cara mengaktifkan kontrol ActiveX.

Catatan

Saat menyelesaikan tutorial ini, jika Anda menerima pesan kesalahan bahwa file DLL tidak dapat dibuat, tutup file PolyCtl.htm dan kontainer Uji Kontrol ActiveX dan buat solusi lagi. Jika Anda masih tidak dapat membuat DLL, boot ulang komputer, atau keluar jika Anda menggunakan Layanan Terminal.

Selanjutnya, Anda akan menambahkan properti kustom ke kontrol.

Kembali ke Langkah 1 | Ke Langkah 3

Lihat juga

Tutorial