AtlEvnt.exe sampel menunjukkan bagaimana untuk menciptakan ATL tenggelam dengan menggunakan kelas ATL IDispEventImpl dan IDispEventSimpleImpl

Visual C++ 6.0

Perkecil gambar iniPerbesar gambar ini

Download Atlevnt.exe sekarang (http://download.microsoft.com/download/vc60pro/sample7/1/WIN98/EN-US/AtlEvnt.exe)

Visual C++.NET

Perkecil gambar iniPerbesar gambar ini

Download Atlevntvcnet.exe sekarang (http://download.microsoft.com/download/visualstudionet/sample/1.11/win98mexp/en-us/Atlevntvcnet.exe)

Kembali ke atas

Gambaran proyek

   dispinterface _EventSink
   {

      properties:
      methods:
      [id(1), helpstring("method Tick")] HRESULT Tick([in] long tckcnt);

   }

				

Kembali ke atas

Langkah-langkah untuk mengimplementasikan IDispEventImpl

1. Menciptakan kelas baru yang berasal dari IDispEventImpl. Kamu bisa Klik Kelas baru pada Masukkan menu untuk menghasilkan kelas baru. Untuk masing-masing berbeda wastafel, menambahkan IDispEventImpl kelas ke daftar warisan dengan ID yang unik sebagai yang pertama parameter. Wastafel kelas dapat menjadi objek COM (seperti dalam komposit kontrol) atau kelas yang hanya berasal dari IdispEventImpl:

   // Just a sink.
         class CSinkObj : public IDispEventImpl<IDC_OBJ, CSinkObj>
         {
            ...
         }

   -atau-

   // COM object that also implements a sink (as in a composite
         // control).
         class ATL_NO_VTABLE CSinkObj :
            public CComObjectRootEx<CComSingleThreadModel>,
            public CComCoClass<CSinkObj, &CLSID_SinkObj>,
            public IDispatchImpl<ISinkObj, &IID_ISinkObj, &LIBID_SINKPROJLib>,
            public IDispEventImpl<IDC_SRCOBJ, CSinkObj>
         {
            ...
         }

2. Anda juga dapat menentukan sumber antarmuka ID, jenis Perpustakaan ID, besar dan kecil versi jumlah perpustakaan jenis yang berisi sumber antarmuka secara eksplisit sebagai parameter IdispEventImpl, atau menggunakan AtlGetObjectSourceInterface() untuk mengekstrak informasi ini dari jenis perpustakaan. Penggunaan AtlGetObjectSourceInterface() mensyaratkan bahwa objek COM penembakan acara menerapkan baik IProvideClassInfo2 atau IPersist *:

   class CSinkObj : public IDispEventImpl<IDC_OBJ, CSinkObj>
         {
            ...
         }

   -atau-

   class CSinkObj : public IDispEventImpl<IDC_OBJ, CSinkObj,
            &DIID__EventSink, // Source interface GUID.
            &LIBID_COMOBJLib, // typelib ID containing source interface.
            1,                // Major version # of LIBID_COMOBJLib.
            0>                // Minor version # of LIBID_COMOBJLib.
         {
            ...
         }

3. Menambahkan peta wastafel untuk kelas atas dan tenggelam masuk sesuai dengan setiap peristiwa antarmuka sumber yang Anda ingin menangani. Menggunakan SINK_ENTRY_EX() ketika antarmuka sumber ditentukan sebagai parameter dalam IDispEventImpl, sebaliknya, menggunakan SINK_ENTRY():

   class CSinkObj : public IDispEventImpl<IDC_SRCOBJ, CSinkObj>
         {
         public:
            BEGIN_SINK_MAP(CSinkObj)
               SINK_ENTRY(IDC_SRCOBJ, 1 /*DISPID*/, OnTick /*Event Handler*/)
            END_SINK_MAP()
            ...
         }

   -atau-

   class CSinkObj : public IDispEventImpl<IDC_OBJ, CSinkObj,
                                 &DIID__EventSink, &LIBID_COMOBJLib, 1, 0>
         {
         public:
            BEGIN_SINK_MAP(CSinkObj)
               SINK_ENTRY_EX(IDC_SRCOBJ, DIID__EventSink, 1, OnTick)
            END_SINK_MAP()
            ...
         }

4. Tambahkan event handler metode untuk kelas Anda. Pastikan mereka memiliki __stdcall memanggil Konvensi:

   class CSinkObj : public IDispEventImpl<IDC_SRCOBJ, CSinkObj3>
         {
         public:
            BEGIN_SINK_MAP(CSinkObj)
               SINK_ENTRY(IDC_SRCOBJ, 1 , OnTick)
            END_SINK_MAP()
   
   
            // event handler for event defined in idl as
            // [id(1)] HRESULT Tick([in] long tckcnt);
            HRESULT __stdcall OnTick(long tickcnt)
            {
               ATLTRACE("CSinkObj::OnTick\n");
               return S_OK;
            }
            ...
         }

5. Menghubungkan tenggelam ke objek COM dengan menelepon DispEventAdvise(). Jika antarmuka sumber ditentukan sebagai parameter untuk IDispEventImpl kemudian panggilan:

   // pUnk is the IUnknown pointer of the COM object that fires events.
      // pSinkObj is an instance of the CSinkObj class.
         pSinkObj->DispEventAdvise(pUnk);

   atau hubungi:

   // Make sure the COM object corresponding to pUnk implements
         // IProvideClassInfo2 or IPersist*.
         // Call this method to extract info about source type library if you
         // specified only two parameters to IdispEventImpl.
         AtlGetObjectSourceInterface(pUnk, &pSinkObj->m_libid,
            &pSinkObj->m_iid, &pSinkObj->m_wMajorVerNum,
            &pSinkObj->m_wMinorVerNum);
   
         hr = pSinkObj->DispEventAdvise(pUnk, &pSinkObj->m_iid);

6. Memutus wastafel dengan menelepon DispEventUnadvise():

   pSinkObj->DispEventUnadvise(pUnk);

Kembali ke atas

Langkah-langkah untuk mengimplementasikan IDispEventSimpleImpl

1. Membuat kelas yang diturunkan dari IDispEventSimpleImpl. The sumber antarmuka harus ditentukan.
2. Ikuti langkah 3 di atas kecuali menambahkan SINK_ENTRY_INFO() untuk masing-masing metode antarmuka sumber yang akan menangani. Sejak IDispEventSimpleImpl tidak memiliki akses ke perpustakaan jenis yang Anda harus menyediakan informasi tentang setiap event handler melalui _ATL_FUNC_INFO struktur, satu untuk setiap event handler.
   
   Alih-alih menentukan Struktur _ATL_FUNC_INFO di SINK_ENTRY_INFO(), Anda dapat menggunakan SINK_ENTRY_EX() makro dan menimpa fungsi virtual GetFuncInfoFromId() untuk mengisi _ATL_FUNC_INFO struktur, seperti yang ditunjukkan dalam kode berikut.
3. Ikuti langkah-langkah 4 sampai 6 dari atas:

   static _ATL_FUNC_INFO OnTickInfo = {
            CC_STDCALL,   // Calling convention.
            VT_I4,        // Return type.
            1,            // Number of arguments.
            {VT_I4}       // Argument types.
         };
   
         class CSinkObj :
            public IDispEventSimpleImpl<IDC_SRCOBJ, CSinkObj,
                   &DIID__EventSink>
         {
         public:
         BEGIN_SINK_MAP(CSinkObj)
            SINK_ENTRY_INFO(IDC_SRCOBJ, DIID__EventSink, 1, OnTick,
                            &OnTickInfo)
         END_SINK_MAP()
   
            HRESULT __stdcall OnTick(long tickcnt)
            {
               ATLTRACE("CSinkObj::OnTick\n");
               return S_OK;
            }
            ...
   
         }

   -atau-

   class CSinkObj :
            public IDispEventSimpleImpl<IDC_SRCOBJ, CSinkObj,
                   &DIID__EventSink>
         {
         public:
         BEGIN_SINK_MAP(CSinkObj4)
            SINK_ENTRY_EX(IDC_SRCOBJ, DIID__EventSink, 1, OnTick)
            // Equivalent to:
            // SINK_ENTRY_INFO(IDC_SRCOBJ, DIID__EventSink, 1, OnTick, NULL)
         END_SINK_MAP()
   
            HRESULT GetFuncInfoFromId(const IID& iid, DISPID dispidMember,
               LCID lcid, _ATL_FUNC_INFO& info)
            {
               if (InlineIsEqualGUID(iid, DIID__EventSink))
               {
                  info.cc = CC_STDCALL;
                  switch(dispidMember)
                  {
                     case 1:
                        info.vtReturn = VT_I4;
                        info.nParams = 1;
                        info.pVarTypes[0] =  VT_I4;
                        return S_OK;
   
                     default:
                        return E_FAIL;
                  }
               }
               return E_FAIL;
            }
   
            HRESULT __stdcall OnTick(long tickcnt)
            {
               ATLTRACE("CSinkObj::OnTick\n");
               return S_OK;
            }
            ...
         }

Kembali ke atas