這個類別提供方法的 IDispatch 實作。
重要
這個類別及其成員不能用於在 Windows 執行階段 中執行的應用程式。
語法
template <UINT nID, class T,
const IID* pdiid = &IID_NULL,
const GUID* plibid = &GUID_NULL,
WORD wMajor = 0,
WORD wMinor = 0,
class tihclass = CcomTypeInfoHolder>
class ATL_NO_VTABLE IDispEventImpl : public IDispEventSimpleImpl<nID, T, pdiid>
參數
nID
來源物件的唯一標識碼。 當 IDispEventImpl 是複合控件的基類時，請使用此參數所需自主控件的資源標識符。 在其他情況下，請使用任意正整數。
T
使用者類別，衍生自 IDispEventImpl。
pdiid
這個類別所實作之事件 dispinterface 之 IID 的指標。 此介面必須定義於、plibidwMajor、 和 wMinor所表示的類型連結庫中。
plibid
類型連結庫的指標，定義 所指向的 pdiid分派介面。 如果 &GUID_NULL為 ，則會從來源事件的物件載入類型庫。
wMajor
類型程式庫的主要版本。 預設值為 0。
wMinor
類型程式庫的次要版本。 預設值為 0。
tihclass
用來管理 之型別 T信息的類別。 默認值是 類型的 CComTypeInfoHolder類別;不過，您可以藉由提供 類型以外的 CComTypeInfoHolder類別來覆寫此範本參數。
成員
公用 Typedefs
| 名稱 | 描述 |
|---|---|
IDispEventImpl::_tihclass |
用來管理型別信息的類別。 根據預設， CComTypeInfoHolder為 。 |
公用建構函式
| 名稱 | 描述 |
|---|---|
IDispEventImpl::IDispEventImpl |
建構函式。 |
公用方法
| 名稱 | 描述 |
|---|---|
IDispEventImpl::GetFuncInfoFromId |
找出指定分派標識子的函式索引。 |
IDispEventImpl::GetIDsOfNames |
將單一成員和一組選擇性的自變數名稱對應至對應的整數 DISPID集合。 |
IDispEventImpl::GetTypeInfo |
擷取 物件的型別資訊。 |
IDispEventImpl::GetTypeInfoCount |
擷取類型資訊介面的數目。 |
IDispEventImpl::GetUserDefinedType |
擷取使用者定義型別的基本類型。 |
備註
IDispEventImpl 提供實作事件散發介面的方式，而不需要您針對該介面上的每個方法/事件提供實作程序代碼。
IDispEventImpl 提供方法的 IDispatch 實作。 您只需要提供您想要處理之事件的實作。
IDispEventImpl 可與類別中的事件接收對應搭配運作，以將事件路由傳送至適當的處理程式函式。 若要使用此類別：
SINK_ENTRY將或 SINK_ENTRY_EX 巨集新增至您想要處理之每個物件上每個事件的事件接收對應。 使用 IDispEventImpl 做為複合控件的基類時，您可以呼叫 AtlAdviseSinkMap 來建立和中斷事件接收對應中所有專案之事件來源的連接。 在其他情況下，或針對更大的控件，呼叫 DispEventAdvise 以建立來源物件與基類之間的連接。 呼叫 DispEventUnadvise 以中斷連線。
您必須針對需要處理事件的每個物件衍生自 IDispEventImpl （使用 唯一的值 nID）。 您可以針對一個來源物件取消加入基類，然後針對不同的來源物件提供建議，但單一物件可以一次處理的來源物件數目上限會受限於基類數目 IDispEventImpl 。
IDispEventImpl 提供與 IDispEventSimpleImpl相同的功能，不同之處在於它會從類型連結庫取得介面的類型資訊，而不是提供它做為結構的指標 _ATL_FUNC_INFO 。
IDispEventSimpleImpl當您沒有描述事件介面的類型庫，或想要避免使用類型連結庫相關聯的額外負荷時使用 。
注意
IDispEventImpl 和 IDispEventSimpleImpl 提供自己的實 IUnknown::QueryInterface 作，讓每個 IDispEventImpl 和 IDispEventSimpleImpl 基類都能作為個別的 COM 身分識別，同時仍然允許直接存取主要 COM 物件中的類別成員。
ActiveX 事件接收的 CE ATL 實作僅支援類型 HRESULT 或 void 事件處理程式方法的傳回值;不支援任何其他傳回值，且其行為未定義。
如需詳細資訊，請參閱 支援 IDispEventImpl。
繼承階層架構
_IDispEvent
_IDispEventLocator
IDispEventImpl
需求
標頭：atlcom.h
IDispEventImpl::GetFuncInfoFromId
找出指定分派標識子的函式索引。
HRESULT GetFuncInfoFromId(
const IID& iid,
DISPID dispidMember,
LCID lcid,
_ATL_FUNC_INFO& info);
參數
iid
[in]函式標識碼的參考。
dispidMember
[in]函式的分派標識碼。
lcid
[in]函式標識碼的地區設定內容。
info
[in]結構，指出如何呼叫函式。
傳回值
標準 HRESULT 值。
IDispEventImpl::GetIDsOfNames
將單一成員和一組選擇性的自變數名稱對應至對應的整數 DISPID集合，以供後續呼叫 IDispatch::Invoke使用。
STDMETHOD(GetIDsOfNames)(
REFIID riid,
LPOLESTR* rgszNames,
UINT cNames,
LCID lcid,
DISPID* rgdispid);
備註
請參閱 IDispatch::GetIDsOfNames Windows SDK。
IDispEventImpl::GetTypeInfo
擷取物件的類型資訊，可以用來取得介面的類型資訊。
STDMETHOD(GetTypeInfo)(
UINT itinfo,
LCID lcid,
ITypeInfo** pptinfo);
IDispEventImpl::GetTypeInfoCount
擷取物件提供的類型資訊介面數目 (0 或 1)。
STDMETHOD(GetTypeInfoCount)(UINT* pctinfo);
備註
請參閱 IDispatch::GetTypeInfoCount Windows SDK。
IDispEventImpl::GetUserDefinedType
擷取使用者定義型別的基本類型。
VARTYPE GetUserDefinedType(
ITypeInfo* pTI,
HREFTYPE hrt);
參數
pTI
[in]包含使用者定義型別之介面的指標 ITypeInfo 。
hrt
[in]要擷取之型別描述的句柄。
傳回值
variant 的類型。
備註
請參閱 ITypeInfo::GetRefTypeInfo。
IDispEventImpl::IDispEventImpl
建構函式。 儲存類別範本參數 plibid、 pdiid、 wMajor和 wMinor的值。
IDispEventImpl();
IDispEventImpl::_tihclass
此 typedef 是類別範本參數 tihclass的實例。
typedef tihclass _tihclass;
備註
根據預設，類別為 CComTypeInfoHolder。
CComTypeInfoHolder 會管理 類別的類型資訊。
另請參閱
_ATL_FUNC_INFO 結構
IDispatchImpl 類
IDispEventSimpleImpl 類
SINK_ENTRY
SINK_ENTRY_EX
SINK_ENTRY_INFO
類別概觀