Bagikan melalui


Wizard Objek Sederhana ATL

Panduan ini menyisipkan ke dalam proyek objek COM minimal. Gunakan halaman wizard ini untuk menentukan nama yang mengidentifikasi kelas C++ dan file untuk objek Anda dan fungsionalitas COM-nya.

Gunakan halaman Opsi wizard ini untuk menentukan model utas objek, dukungan agregasinya, dan apakah mendukung antarmuka ganda dan Automation. Anda juga dapat menunjukkan dukungan untuk antarmuka informasi kesalahan, titik koneksi, dukungan Internet Explorer, dan marshaling utas bebas.

Keterangan

Dimulai dengan Visual Studio 2008, skrip pendaftaran yang dihasilkan oleh wizard ini akan mendaftarkan komponen COM-nya di bawah HKEY_CURRENT_USER alih-alih HKEY_LOCAL_MACHINE. Untuk mengubah perilaku ini, atur opsi Daftarkan komponen untuk semua pengguna wizard ATL.

Nama

Tentukan nama untuk objek, antarmuka, dan kelas yang akan ditambahkan ke proyek Anda. Kecuali untuk Nama pendek, semua kotak lain dapat diedit secara independen dari yang lain. Jika Anda mengubah teks untuk Nama pendek, perubahan tercermin dalam nama semua kotak lain di halaman ini. Jika Anda mengubah nama Coclass di bagian COM, perubahan tercermin dalam kotak Jenis dan ProgID , tetapi nama Antarmuka tidak berubah. Perilaku penamaan ini dirancang untuk membuat semua nama mudah diidentifikasi untuk Anda saat Anda mengembangkan kontrol Anda.

Catatan

Coclass hanya dapat diedit pada proyek yang tidak diganggu. Jika proyek Anda dikaitkan, Anda tidak dapat mengedit Coclass.

C++

Menyediakan informasi untuk kelas C++ yang dibuat untuk objek.

  • Nama pendek

    Mengatur nama singkatan untuk objek. Nama yang Anda berikan menentukan Class nama dan Coclass , file .cpp dan nama file .h, nama Antarmuka , Nama jenis , dan ProgID, kecuali Anda mengubah bidang tersebut satu per satu.

  • .h file

    Mengatur nama file header untuk kelas objek baru. Secara default, nama ini didasarkan pada nama yang Anda berikan dalam Nama pendek. Klik tombol elipsis untuk menyimpan nama file ke lokasi pilihan Anda, atau untuk menambahkan deklarasi kelas ke file yang sudah ada. Jika Anda memilih file yang sudah ada, wisaya tidak akan menyimpannya ke lokasi terpilih hingga Anda mengklik Selesai dalam panduan.

    Wisaya tidak menimpa file. Jika Anda memilih nama file yang sudah ada, saat Anda mengklik Selesai, wizard akan meminta Anda untuk menunjukkan apakah deklarasi kelas harus ditambahkan ke konten file. Klik Ya untuk menambahkan file; klik Tidak untuk kembali ke wizard dan tentukan nama file lain.

  • Kelas

    Mengatur nama kelas yang akan dibuat. Nama ini didasarkan pada nama yang Anda berikan dalam Nama pendek, didahului oleh 'C', awalan umum untuk nama kelas.

  • .cpp file

    Mengatur nama file implementasi untuk kelas objek baru. Secara default, nama ini didasarkan pada nama yang Anda berikan dalam Nama pendek. Klik tombol elipsis untuk menyimpan nama file ke lokasi pilihan Anda. File tidak disimpan ke lokasi terpilih sampai Anda mengklik Selesai dalam panduan.

    Wisaya tidak menimpa file. Jika Anda memilih nama file yang sudah ada, saat Anda mengklik Selesai, wizard akan meminta Anda untuk menunjukkan apakah implementasi kelas harus ditambahkan ke konten file. Klik Ya untuk menambahkan file; klik Tidak untuk kembali ke wizard dan tentukan nama file lain.

  • Dikaitkan

    Menunjukkan apakah objek menggunakan atribut. Jika Anda menambahkan objek ke proyek ATL yang diatribusikan, opsi ini dipilih dan tidak tersedia untuk diubah. Artinya, Anda hanya dapat menambahkan objek yang diatribusikan ke proyek yang dibuat dengan dukungan atribut.

    Anda hanya dapat menambahkan objek yang diatribusikan ke proyek ATL yang menggunakan atribut. Jika Anda memilih opsi ini untuk proyek ATL yang tidak memiliki dukungan atribut, wizard akan meminta Anda untuk menentukan apakah Anda ingin menambahkan dukungan atribut ke proyek.

    Secara default, objek apa pun yang Anda tambahkan setelah Anda mengatur opsi ini ditetapkan sebagai dikaitkan (kotak centang dipilih). Anda dapat menghapus kotak ini untuk menambahkan objek yang tidak menggunakan atribut.

    Lihat Pengaturan Aplikasi, Wizard Proyek ATL, dan Mekanisme dasar atribut untuk informasi selengkapnya.

COM

Menyediakan informasi tentang fungsionalitas COM untuk objek.

  • Coclass

    Mengatur nama kelas komponen yang berisi daftar antarmuka yang didukung oleh objek.

    Catatan

    Jika Anda membuat proyek menggunakan atribut, atau jika Anda menunjukkan pada halaman wizard ini bahwa objek menggunakan atribut, Anda tidak dapat mengubah opsi ini karena ATL tidak menyertakan coclass atribut .

  • Jenis

    Mengatur deskripsi objek yang akan muncul di registri

  • Interface

    Mengatur antarmuka yang Anda buat untuk objek Anda. Antarmuka ini berisi metode kustom Anda.

  • ProgID

    Mengatur nama yang dapat digunakan kontainer alih-alih CLSID objek.

Lihat juga

Objek Sederhana ATL