IDispEventImpl sınıfı

Makale
02/26/2013

Bu sınıf uygulamaları sağlar IDispatch yöntemleri.

Önemli
Bu sınıf ve üyeleri, yürütme uygulamalar kullanılamaz Windows Çalışma Zamanı.

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>

Parametreler

nID
Kaynak nesne için benzersiz bir tanımlayıcı.Zaman IDispEventImpl taban sınıftır bileşik denetim için istediğiniz içerdiği denetim kaynak kimliği için bu parametreyi kullanın.Diğer durumlarda, rasgele pozitif bir tamsayı kullanın.
T
Türetilir kullanıcı sınıfı IDispEventImpl.
pdiid
Bu sınıf tarafından uygulanan olay görüntüleme arabirimi, IID için işaretçi.Bu arabirim tarafından belirtilen tür kitaplığı tanımlanması gereken plibid, wMajor, ve wMinor.
plibid
Tarafından için dağıtma arabirimi tanımlayan Tür kitaplığı için bir işaretçi işaret pdiid.& GUID_NULL, tür kitaplığının olaylarını kaynak nesnesinden yüklenecektir.
wMajor
Tür kitaplığı ana sürüm.Varsayılan değer 0'dir.
wMinor
Tür kitaplığı sürümü.Varsayılan değer 0'dir.
tihclass
Tür bilgileri yönetmek için kullanılan sınıf T.Varsayılan değer türü sınıfıdır CComTypeInfoHolder; sınıf türü dışında sağlayarak bu şablona parametre ancak kılabilirsiniz CComTypeInfoHolder.

Üyeler

TypeDef genel

Ad	Description
IDispEventImpl sınıfı	Tür bilgileri yönetmek için kullanılan sınıf.Varsayılan olarak, CComTypeInfoHolder.

Ortak Oluşturucusu

Ad	Description
IDispEventImpl::IDispEventImpl	Oluşturucu.

Public yöntemler

Ad	Description
IDispEventImpl::GetFuncInfoFromId	Belirtilen gönderim tanımlayıcı işlevi dizini bulur.
IDispEventImpl::GetIDsOfNames	Tek bir üye ve bağımsız değişken adlarını isteğe bağlı bir kümesi için karşılık gelen tamsayı DISPID değerleri kümesi eşleştirir.
IDispEventImpl::GetTypeInfo	Nesne türü bilgilerini alır.
IDispEventImpl::GetTypeInfoCount	Tür bilgileri arabirimleri sayısını alır.
IDispEventImpl::GetUserDefinedType	Kullanıcı tanımlı türü temel tür alır.

Notlar

IDispEventImplBu arabirimdeki her yöntem/olay için uygulama kodu sağlamak için gerek kalmadan olay görüntüleme arabirimi uygulayan bir yol sağlar.IDispEventImpluygulamaları sağlar IDispatch yöntemleri.Yalnızca olayları işlemede ilgilenen uygulamaları sağlamanız gerekir.

IDispEventImplbirlikte çalışır Olay havuzunu harita kendi sınıfında yol olaylara uygun işleyici işlevi.Bu sınıf kullanmak için:

Add bir SINK_ENTRY veya SINK_ENTRY_EX ele almak istediğiniz her bir nesnedeki her olay için Olay havuzunu haritası makro.Kullanırken, IDispEventImpl çağırabileceğiniz bir birleşik denetimin temel bir sınıf olarak AtlAdviseSinkMap kurmak ve tüm girişleri haritası olay havuzu için olay kaynağı ile bağlantıyı kesmek için.Diğer durumlarda ya da daha fazla denetim için çağrı DispEventAdvise kaynak nesne ve temel sınıf arasında bağlantı kurmak için.Call DispEventUnadvise bağlantıyı kesmek için.

Türetilmesi gerekir IDispEventImpl (için benzersiz bir değer kullanarak nID), olayları işlemek için gereksinim duyduğunuz her nesne için.Farklı kaynak nesne karşı bildiren bir kaynak nesnesine karşı unadvising tarafından temel sınıf tekrar kullanabilirsiniz, ancak aynı anda tek bir nesne ele alınması kaynak nesnelerin en fazla sayısını sayısı ile sınırlı IDispEventImpl temel sınıfları.

IDispEventImplaynı işlevi sağlayan IDispEventSimpleImpl, sağlanan bir işaretçi olarak sahip olmak yerine bir tür kitaplığı türü arabirimi hakkında bilgi alır dışında bir _ATL_FUNC_INFO yapısı.Use IDispEventSimpleImpl ne zaman değil olay arabirimini tanımlayan bir tür kitaplığı sahipseniz veya tür kitaplığı kullanımıyla ilişkili giderlerinden kaçınmak istiyor.

[!NOT]

IDispEventImplve IDispEventSimpleImpl , kendi uygulama sağlamak IUnknown::QueryInterface her etkinleştirme IDispEventImpl ve IDispEventSimpleImpl taban sınıf üyeleri doğrudan erişim ana com nesnesinde hala verirken ayrı bir com kimliği olarak davranmasını sınıfı.

Olay havuzlarını destekleyen yalnızca ActiveX ce atl uygulaması türü hresult değerleri döndürebilir veya olay işleyicisi yöntemlerinizi void; diğer bir dönüş değeri desteklenmez ve davranışı tanımsızdır.

Daha fazla bilgi için bkz: Destek IDispEventImpl.