ATL IDispEventImpl ve IDispEventSimpleImpl sýnýflarý kullanarak ATL havuzlarýný oluþturur nasýl AtlEvnt.exe örnek gösterir

Visual C++ 6.0

Bu resmi kapatBu resmi aç

Download Atlevnt.exe now (http://download.microsoft.com/download/vc60pro/sample7/1/win98/en-us/atlevnt.exe)

Visual C++ .NET

Bu resmi kapatBu resmi aç

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

Üste

Projeye genel bakýþ

   dispinterface _EventSink
   {

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

   }

				

Üste

IDispEventImpl uygulamak için gerekli adýmlarý

1. IDispEventImpl ' türetilmiþ bir sýnýf oluþturun. Yeni bir sýnýf oluþturmak için Ekle menüsünden Yeni sýnýf ' ý týklatabilirsiniz. Her farklý havuzu için bir IDispEventImpl sýnýfý ilk parametre olarak benzersiz bir KIMLIK ile <a1>devralma</a1> listesine ekleyin. Havuzu sýnýfý, bir COM nesnesi (olarak bileþik denetim için) veya yalnýzca IdispEventImpl ' türetilmiþ bir sýnýf olabilir:

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

   - veya -

   // 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. Kaynak arabirim KIMLIÐI, tür kitaplýðý KIMLIÐI, birincil ve ikincil sürüm numaralarý kaynak arabirimi, açýkça IdispEventImpl parametre olarak içeren tür kitaplýðý belirtin, veya bu bilgileri, tür kitaplýðýndan ayýklamak için AtlGetObjectSourceInterface() kullanýn. Olay tetikleme COM nesnesi IProvideClassInfo2 veya IPersist * uygulamak AtlGetObjectSourceInterface() kullanýlmasýný gerektirir:

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

   - veya -

   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. Yukarýdaki sýnýf ve kaynak arabiriminin iþlemek istediðiniz her olaya karþýlýk gelen bir havuz giriþ havuzu eþleme ekleyin. Kaynak arabirim olarak bir parametre IDispEventImpl, aksi halde belirtilen SINK_ENTRY_EX() kullanýn, SINK_ENTRY() kullanýn:

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

   - veya -

   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. Olay iþleyicisi yöntemleri Sýnýfýnýza ekleyin. Çaðýrma __stdcall sahip olduklarýndan emin olun:

   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. Havuz arama DispEventAdvise() tarafýndan COM nesnesine baðlanýn. Sonra kaynak arabirimi IDispEventImpl parametre olarak belirtilmiþse, arama:

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

   veya baþka bir çaðrý:

   // 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. Havuz DispEventUnadvise() ça??rarak kesme:

   pSinkObj->DispEventUnadvise(pUnk);

Üste

IDispEventSimpleImpl uygulamak için gerekli adýmlarý

1. IDispEventSimpleImpl ' türetilmiþ bir sýnýf oluþturun. Kaynak arabirimi belirtilmesi gerekir.
2. Aþaðýdaki adým 3 yukarýdaki dýþýnda SINK_ENTRY_INFO() iþlemek istediðiniz kaynak arabirimi için her yöntemi ekleyin. IDispEventSimpleImpl tür kitaplýðýna eriþimi olmayan bu yana bir _ATL_FUNC_INFO yapýsýnda her olay iþleyici, her olay iþleyici için bir tane hakkýnda bilgi vermek zorundasýnýz.
   
   SINK_ENTRY_EX() kullanabileceðiniz bir _ATL_FUNC_INFO yapýsý içinde SINK_ENTRY_INFO() belirtmek yerine, makro ve geçersiz kýlma sanal iþlevi _ATL_FUNC_INFO doldurmak için GetFuncInfoFromId() yapýsý, aþaðýdaki gösterildiði gibi.
3. Yukarýdaki gelen 4-6 arasýndaki adýmlarý izleyin:

   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;
            }
            ...
   
         }

   - veya -

   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;
            }
            ...
         }

Üste