AtlEvnt.exe exemplo mostra como cria ATL PIAs utilizando as classes ATL IDispEventImpl e IDispEventSimpleImpl

Visual C++ 6.0

Reduzir esta imagemExpandir esta imagem

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

Visual C++ .NET

Reduzir esta imagemExpandir esta imagem

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

Voltar ao topo

Descrição geral do projecto

   dispinterface _EventSink
   {

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

   }

				

Voltar ao topo

Passos para implementar IDispEventImpl

1. Crie uma nova classe derivada de IDispEventImpl. Pode clicar em Nova classe no menu Inserir para gerar uma nova classe. Para cada receptor diferente, adicione uma classe IDispEventImpl à lista de herança com um ID exclusivo como o primeiro parâmetro. A classe receptor pode ser um objecto COM (como num controlo composto) ou uma classe que deriva apenas IdispEventImpl:

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

   - ou -

   // 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. Pode especificar o ID de interface de origem, o ID da biblioteca de tipo, números de versão principal e secundária da biblioteca de tipo que contém a interface de origem explicitamente como parâmetros de IdispEventImpl ou utilizar o AtlGetObjectSourceInterface() para extrair estas informações de biblioteca de tipos. Utilização AtlGetObjectSourceInterface() requer que o objecto COM accionar o evento implementar IProvideClassInfo2 ou IPersist *:

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

   - ou -

   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. Adicione um mapa de receptor de classe acima e uma entrada de receptor correspondente a cada evento de uma interface de origem que pretende processar. Utilizar SINK_ENTRY_EX() quando a interface de origem especificada como um parâmetro no IDispEventImpl, caso contrário, utilize 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()
            ...
         }

   - ou -

   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. Adicione métodos de rotina de tratamento de eventos à classe. Certifique-se que tem __stdcall convenção de chamada:

   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. Ligar o receptor ao objecto COM por DispEventAdvise() chamada. Se a interface de origem é especificada como um parâmetro para IDispEventImpl, em seguida, ligue para:

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

   ou outra chamada:

   // 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. Desligar o receptor chamando DispEventUnadvise():

   pSinkObj->DispEventUnadvise(pUnk);

Voltar ao topo

Passos para implementar IDispEventSimpleImpl

1. Crie uma classe derivada de IDispEventSimpleImpl. A interface de origem tem de ser especificado.
2. Siga o passo 3 acima excepto adicionar SINK_ENTRY_INFO() para cada método de uma interface de origem que pretende processar. Uma vez que IDispEventSimpleImpl não tem acesso à biblioteca de tipos tem de fornecer informações sobre cada processador de eventos através de uma estrutura _ATL_FUNC_INFO, uma para cada processador de eventos.
   
   Em vez de especificar uma estrutura _ATL_FUNC_INFO em SINK_ENTRY_INFO(), pode utilizar o SINK_ENTRY_EX() macros e substituir a função virtual GetFuncInfoFromId() para preencher o _ATL_FUNC_INFO estruturar, como mostrado no seguinte código.
3. Siga os passos 4 a 6 de cima:

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

   - ou -

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

Voltar ao topo