Membuat antarmuka COM

Visual Studio menyediakan wizard dan templat untuk membuat proyek yang menggunakan antarmuka penentu COM dan dispinterfaces untuk objek COM dan kelas automasi Anda.

Anda dapat menggunakan wizard ini untuk melakukan tiga tugas umum berikut ini:

  • Tambahkan dukungan ATL ke proyek MFC Anda.

    Tambahkan dukungan ATL ke aplikasi MFC setelah Anda membuat proyek MFC menggunakan Wizard aplikasi MFC dan menjalankan wizard kode Tambahkan Dukungan ATL ke MFC. Dukungan ini hanya berlaku untuk objek COM sederhana yang ditambahkan ke proyek MFC yang dapat dieksekusi atau DLL. Objek ATL ini mungkin memiliki lebih dari satu antarmuka.

  • Membuat kontrol ActiveX MFC.

    Buka wizard kontrol ActiveX MFC untuk membuat kontrol ActiveX dengan dispinterface dan peta peristiwa yang ditentukan dalam file .idl dan kelas kontrol.

  • Tambahkan kontrol ATL.

    Gunakan kombinasi wizard proyek ATL dan wizard kontrol ATL untuk membuat kontrol ActiveX ATL.

    Anda juga dapat menambahkan kontrol ATL ke proyek MFC yang telah Anda tambahkan dukungan ATL, seperti yang dijelaskan di atas. Selain itu, jika Anda memilih Kontrol ATL dalam kotak dialog Tambahkan Kelas, dan Anda belum menambahkan dukungan ATL ke proyek MFC Anda, Visual Studio menampilkan kotak dialog yang mengonfirmasi penambahan dukungan ATL ke proyek MFC Anda.

    Wizard ini menghasilkan sumber IDL dan peta COM di kelas proyek.

Setelah proyek ATL terbuka, kotak dialog Tambahkan Kelas memberikan Anda pilihan wizard dan templat tambahan untuk menambahkan antarmuka COM ke proyek Anda. Wizard berikut ini memungkinkan Anda untuk membuat satu atau beberapa antarmuka untuk objek:

Selain itu, Anda dapat menerapkan antarmuka baru pada kontrol COM Anda. Cukup klik kanan kelas kontrol objek di Tampilan Kelas dan pilih Terapkan Antarmuka.

Catatan

Visual Studio tidak menyediakan wizard untuk menambahkan antarmuka ke proyek. Anda dapat menambahkan antarmuka ke proyek ATL atau ke Tambahkan dukungan ATL ke proyek MFC Anda dengan menambahkan objek sederhana menggunakan wizard objek sederhana ATL. Secara bergantian, buka file .idl milik proyek dan buat antarmuka dengan mengetik:

interface IMyInterface {
};

Untuk informasi selengkapnya, lihat Menerapkan antarmuka dan Menambahkan objek dan kontrol ke proyek ATL.

Visual C++ menyediakan beberapa cara untuk melihat dan mengedit antarmuka COM yang ditentukan untuk proyek Anda. Tampilan Kelas menampilkan ikon untuk antarmuka atau dispinterface apa pun yang ditentukan dalam file .idl di proyek C++ Anda.

Untuk kelas objek COM berbasis ATL, Tampilan Kelas membaca peta COM di kelas ATL untuk menampilkan hubungan antara kelas ATL dan antarmuka apa pun yang diterapkannya.

Di Tampilan Kelas dan menu pintasannya, Anda dapat bekerja dengan antarmuka sebagai berikut:

  • Menambahkan objek ATL ke aplikasi berbasis MFC.
  • Menambahkan metode, properti, dan kejadian.
  • Lompat langsung ke kode antarmuka item dengan mengeklik dua kali item tersebut.

Di bagian ini

Mengedit antarmuka COM

Dengan menggunakan perintah dari menu pintasan Tampilan Kelas, Anda dapat menentukan metode dan properti baru untuk antarmuka COM di proyek C++ Visual Studio Anda. Dari Kotak Alat, Anda juga dapat menentukan kejadian untuk kontrol ActiveX.

Untuk kelas objek COM berbasis ATL- dan MFC-, Anda dapat mengedit penerapan kelas bersamaan dengan pengeditan antarmuka.

Catatan

Untuk antarmuka yang telah Anda tentukan di luar kotak dialog Tambahkan Kelas, Visual C++ menambahkan metode atau properti ke file .idl, dan menambahkan stub ke kelas yang menerapkan metode, bahkan ketika antarmuka ditambahkan secara manual.

Tiga wizard berikut ini membantu Anda menyesuaikan antarmuka yang sudah ada. Mereka tersedia dari Tampilan Kelas:

Penyihir Jenis proyek
Menambahkan wizard properti Proyek ATL atau MFC yang mendukung ATL. Klik kanan antarmuka yang ingin Anda tambahkan propertinya.

Visual C++ mendeteksi jenis proyek dan memodifikasi opsi dalam Wizard Tambahkan Properti seperlunya:

- Untuk dispinterfaces dalam proyek yang dibuat dengan menggunakan Wizard aplikasi MFC, menggunakan Wizard Tambah Properti menyediakan opsi khusus untuk MFC.
- Untuk antarmuka kontrol ActiveX MFC, Wizard Tambahkan Properti menyediakan daftar metode stok dan properti yang dapat Anda gunakan sebagaimana yang disediakan atau disesuaikan untuk kontrol Anda.
- Untuk semua antarmuka lainnya, Wizard Tambahkan Properti menyediakan opsi yang berguna dalam sebagian besar situasi.
Menambahkan wizard metode Proyek ATL atau MFC yang menunjang ATL. Klik kanan antarmuka yang ingin Anda tambahkan metodenya.

Visual C++ mendeteksi jenis proyek dan memodifikasi opsi dalam Wizard Tambahkan Metode seperlunya:

- Untuk dispinterfaces dalam proyek yang dibuat menggunakan Wizard aplikasi MFC, penggunaan Wizard Tambah Metode menyediakan opsi khusus untuk MFC.
- Untuk antarmuka kontrol ActiveX MFC, Wizard Tambahkan Metode menyediakan daftar metode stok dan properti yang dapat Anda gunakan sebagaimana disediakan atau sesuaikan untuk kontrol Anda.
- Untuk semua antarmuka lainnya, wizard Tambahkan Metode menyediakan opsi yang berguna dalam sebagian besar situasi.

Selain itu, Anda dapat menerapkan antarmuka baru pada kontrol COM Anda. Cukup klik kanan kelas kontrol objek di Tampilan Kelas dan pilih Terapkan Antarmuka.

  • Last updated on