Clase IDispEventSimpleImpl
Esta clase proporciona implementaciones de los métodos IDispatch, sin obtener información de tipo de una biblioteca de tipos.
Importante
Esta clase y sus miembros no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.
Sintaxis
template <UINT nID, class T, const IID* pdiid>
class ATL_NO_VTABLE IDispEventSimpleImpl : public _IDispEventLocator<nID, pdiid>
Parámetros
Nid
Un identificador único para el objeto de origen. Cuando IDispEventSimpleImpl es la clase base de un control compuesto, use el id. de recurso del control contenido que quiera para este parámetro. En otros casos, use un número entero positivo arbitrario.
T
La clase del usuario, que se deriva de IDispEventSimpleImpl.
pdiid
El puntero al IID del evento dispinterface implementado por esta clase.
Miembros
Métodos públicos
| Nombre | Descripción |
|---|---|
| IDispEventSimpleImpl::Advise | Establece una conexión con el origen del eventos predeterminado. |
| IDispEventSimpleImpl::DispEventAdvise | Establece una conexión con el origen del evento. |
| IDispEventSimpleImpl::DispEventUnadvise | Interrumpe la conexión con el origen del evento. |
| IDispEventSimpleImpl::GetIDsOfNames | Devuelve E_NOTIMPL. |
| IDispEventSimpleImpl::GetTypeInfo | Devuelve E_NOTIMPL. |
| IDispEventSimpleImpl::GetTypeInfoCount | Devuelve E_NOTIMPL. |
| IDispEventSimpleImpl::Invoke | Llama a los controladores de eventos enumerados en el mapa de receptor de eventos. |
| IDispEventSimpleImpl::Unadvise | Interrumpe la conexión con el origen del evento predeterminado. |
Comentarios
IDispEventSimpleImpl proporciona una manera de implementar un evento dispinterface sin necesidad de proporcionar un código de implementación para cada método o evento en esa interfaz. IDispEventSimpleImpl proporciona implementaciones de los métodos IDispatch. Solo tiene que proporcionar implementaciones para los eventos que le interesa controlar.
IDispEventSimpleImpl funciona junto con el mapa de receptor de eventos en la clase para enrutar los eventos a la función de controlador adecuada. Para usar esta clase:
Agregue una macro SINK_ENTRY_INFO al mapa de receptor del evento para cada evento de cada objeto que quiera controlar.
Proporcione información de tipo para cada evento al pasar un puntero a una estructura _ATL_FUNC_INFO como parámetro a cada entrada. En la plataforma x86, el valor
_ATL_FUNC_INFO.ccdebe ser CC_CDECL con el método de llamada a la función de devolución de llamada de __stdcall.Llame a DispEventAdvise para establecer la conexión entre el objeto de origen y la clase base.
Llame a DispEventUnadvise para interrumpir la conexión.
Debe derivar de IDispEventSimpleImpl (mediante un valor único para nID) para cada objeto del que necesite controlar los eventos. Puede volver a usar la clase base si quita un objeto de origen y, a continuación, avisa a otro objeto de origen diferente. Sin embargo, el número máximo de objetos de origen que puede controlar un solo objeto a la vez está limitado por el número de clases base IDispEventSimpleImpl.
IDispEventSimplImpl proporciona la misma funcionalidad que IDispEventImpl, excepto que no obtiene información de tipo sobre la interfaz de una biblioteca de tipos. Los asistentes generan código basado solo en IDispEventImpl, pero puede usar IDispEventSimpleImpl si agrega el código manualmente. Use IDispEventSimpleImpl cuando no tenga una biblioteca de tipos que describa la interfaz de eventos o quiera evitar la sobrecarga derivada del uso de la biblioteca de tipos.
Nota:
IDispEventImply IDispEventSimpleImpl proporcionan su propia implementación de IUnknown::QueryInterface que permite que cada clase IDispEventImpl o IDispEventSimpleImpl clase base actúe como una identidad COM independiente, a la vez que permite el acceso directo a los miembros de clase en el objeto COM principal.
La implementación ATL de CE de receptores de eventos ActiveX solo admite valores devueltos de tipo HRESULT o void de los métodos del controlador de eventos; no se admite ningún otro valor devuelto y su comportamiento no está definido.
Para más información, vea Compatibilidad con IDispEventImpl.
Jerarquía de herencia
_IDispEvent
_IDispEventLocator
IDispEventSimpleImpl
Requisitos
Encabezado: atlcom.h
IDispEventSimpleImpl::Advise
Llame a este método para establecer una conexión con el origen del evento representado por pUnk.
HRESULT Advise(IUnknown* pUnk);
Parámetros
pUnk
[in] Puntero a la interfaz IUnknown del objeto de origen del evento.
Valor devuelto
S_OK o cualquier otro valor HRESULT de error.
Comentarios
Una vez establecida la conexión, los eventos desencadenados desde pUnk se enrutarán a los controladores de la clase mediante el mapa de receptor de eventos.
Nota:
Si la clase se deriva de varias clases IDispEventSimpleImpl, deberá eliminar la ambigüedad de las llamadas a este método estableciendo el ámbito de la llamada con la clase base concreta que le interesa.
Advise establece una conexión y obtiene el IID con el origen del evento predeterminado del objeto, tal y como viene determinado porAtlGetObjectSourceInterface.
IDispEventSimpleImpl::DispEventAdvise
Llame a este método para establecer una conexión con el origen del evento representado por pUnk.
HRESULT DispEventAdvise(IUnknown* pUnk const IID* piid);
Parámetros
pUnk
[in] Puntero a la interfaz IUnknown del objeto de origen del evento.
piid
Puntero al IID del objeto de origen del evento.
Valor devuelto
S_OK o cualquier otro valor HRESULT de error.
Comentarios
Posteriormente, los eventos desencadenados desde pUnk se enrutarán a los controladores de la clase mediante el mapa de receptor de eventos.
Nota:
Si la clase se deriva de varias clases IDispEventSimpleImpl, deberá eliminar la ambigüedad de las llamadas a este método estableciendo el ámbito de la llamada con la clase base concreta que le interesa.
DispEventAdvise establece una conexión con el origen del evento especificado en pdiid.
IDispEventSimpleImpl::DispEventUnadvise
Interrumpe la conexión con el origen del evento representado por pUnk.
HRESULT DispEventUnadvise(IUnknown* pUnk const IID* piid);
Parámetros
pUnk
[in] Puntero a la interfaz IUnknown del objeto de origen del evento.
piid
Puntero al IID del objeto de origen del evento.
Valor devuelto
S_OK o cualquier otro valor HRESULT de error.
Comentarios
Una vez interrumpida la conexión, los eventos ya no se enrutarán a las funciones de controlador enumeradas en el mapa de receptor de eventos.
Nota:
Si la clase se deriva de varias clases IDispEventSimpleImpl, deberá eliminar la ambigüedad de las llamadas a este método estableciendo el ámbito de la llamada con la clase base concreta que le interesa.
DispEventAdvise interrumpe una conexión establecida con el origen del evento especificado en pdiid.
IDispEventSimpleImpl::GetIDsOfNames
Esta implementación de IDispatch::GetIDsOfNames devuelve E_NOTIMPL.
STDMETHOD(GetIDsOfNames)(
REFIID /* riid */,
LPOLESTR* /* rgszNames */,
UINT /* cNames */,
LCID /* lcid */,
DISPID* /* rgdispid */);
Comentarios
Consulte IDispatch::GetIDsOfNames en Windows SDK.
IDispEventSimpleImpl::GetTypeInfo
Esta implementación de IDispatch::GetTypeInfo devuelve E_NOTIMPL.
STDMETHOD(GetTypeInfo)(
UINT /* itinfo */,
LCID /* lcid */,
ITypeInfo** /* pptinfo */);
Comentarios
Consulte IDispatch::GetTypeInfo en Windows SDK.
IDispEventSimpleImpl::GetTypeInfoCount
Esta implementación de IDispatch::GetTypeInfoCount devuelve E_NOTIMPL.
STDMETHOD(GetTypeInfoCount)(UINT* /* pctinfo */);
Comentarios
Consulte IDispatch::GetTypeInfoCount en Windows SDK.
IDispEventSimpleImpl::Invoke
Esta implementación de IDispatch::Invoke llama a los controladores de eventos enumerados en el mapa de receptor de eventos.
STDMETHOD(Invoke)(
DISPID dispidMember,
REFIID /* riid */,
LCID lcid,
WORD /* wFlags */,
DISPPARMS* pdispparams,
VARIANT* pvarResult,
EXCEPINFO* /* pexcepinfo */,
UINT* /* puArgErr */);
Comentarios
Consulte IDispatch::Invoke.
IDispEventSimpleImpl::Unadvise
Interrumpe la conexión con el origen del evento representado por pUnk.
HRESULT Unadvise(IUnknown* pUnk);
Parámetros
pUnk
[in] Puntero a la interfaz IUnknown del objeto de origen del evento.
Valor devuelto
S_OK o cualquier otro valor HRESULT de error.
Comentarios
Una vez interrumpida la conexión, los eventos ya no se enrutarán a las funciones de controlador enumeradas en el mapa de receptor de eventos.
Nota:
Si la clase se deriva de varias clases IDispEventSimpleImpl, deberá eliminar la ambigüedad de las llamadas a este método estableciendo el ámbito de la llamada con la clase base concreta que le interesa.
Unadvise interrumpe una conexión que se ha establecido con el origen del evento predeterminado especificado en pdiid.
Unavise interrumpe una conexión con el origen del evento predeterminado, obtiene el IID del origen del evento predeterminado del objeto tal y como se determina en AtlGetObjectSourceInterface.
Consulte también
_ATL_FUNC_INFO (estructura)
IDispatchImpl (clase)
IDispEventImpl (clase)
SINK_ENTRY_INFO
Información general sobre la clase
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de