CComUnkArray Sınıfı
Bu sınıf işaretçileri depolar IUnknown ve IConnectionPointImpl şablon sınıfına parametre olarak kullanılmak üzere tasarlanmıştır.
Sözdizimi
template<unsigned int nMaxSize>
class CComUnkArray
Parametreler
nMaxSize
Statik dizide tutulabilecek işaretçi sayısı üst sınırı IUnknown .
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CComUnkArray::CComUnkArray | Oluşturucu. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CComUnkArray::Add | Diziye bir IUnknown işaretçi eklemek için bu yöntemi çağırın. |
| CComUnkArray::begin | Koleksiyondaki ilk IUnknown işaretçiye bir işaretçi döndürür. |
| CComUnkArray::end | Koleksiyondaki son IUnknown işaretçiyi geçen işaretçiyi döndürür. |
| CComUnkArray::GetCookie | Belirli IUnknown bir işaretçiyle ilişkili tanımlama bilgisini almak için bu yöntemi çağırın. |
| CComUnkArray::GetUnknown | Belirli bir tanımlama bilgisi ile ilişkili işaretçiyi IUnknown almak için bu yöntemi çağırın. |
| CComUnkArray::Remove | Diziden bir IUnknown işaretçiyi kaldırmak için bu yöntemi çağırın. |
Açıklamalar
CComUnkArray her biri bir bağlantı noktasındaki bir arabirim olan sabit sayıda IUnknown işaretçi içerir. CComUnkArrayIConnectionPointImpl şablon sınıfına parametre olarak kullanılabilir. CComUnkArray<1> , bir bağlantı noktası için iyileştirilmiş bir şablon özelleştirmesidir CComUnkArray .
Başlangıç CComUnkArray ve bitiş yöntemleri tüm bağlantı noktaları arasında döngü yapmak için kullanılabilir (örneğin, bir olay tetiklendiğinde).
Bağlantı noktası proxy'lerinin oluşturulmasını otomatikleştirme hakkında ayrıntılı bilgi için bkz . Nesneye Bağlantı Noktaları Ekleme.
Not
Not CComDynamicUnkArray sınıfı, Bağlantı Noktaları olan bir denetim oluşturulurken Sınıf Ekle sihirbazı tarafından kullanılır. Bağlantı Noktası sayısını el ile belirtmek isterseniz, başvuruyu CComDynamicUnkArray CComUnkArray< olarak >n olarak değiştirin; burada n, gereken bağlantı noktası sayısıdır.
Gereksinimler
Üst bilgi: atlcom.h
CComUnkArray::Add
Diziye bir IUnknown işaretçi eklemek için bu yöntemi çağırın.
DWORD Add(IUnknown* pUnk);
Parametreler
Punk
Diziye bir IUnknown işaretçi eklemek için bu yöntemi çağırın.
Dönüş Değeri
Yeni eklenen işaretçiyle ilişkili tanımlama bilgisini veya dizi yeni işaretçiyi içerecek kadar büyük değilse 0 değerini döndürür.
CComUnkArray::begin
Arabirim işaretçileri koleksiyonunun IUnknown başına bir işaretçi döndürür.
IUnknown**
begin();
Dönüş Değeri
Arabirim işaretçisine yönelik bir IUnknown işaretçi.
Açıklamalar
Koleksiyon, olarak IUnknownyerel olarak depolanan arabirimlere yönelik işaretçiler içerir. Her IUnknown arabirimi gerçek arabirim türüne yayınlar ve ardından bu arabirim üzerinden çağrırsınız. Önce arabirimi sorgulamanız gerekmez.
Arabirimi kullanmadan IUnknown önce NULL olup olmadığını denetlemeniz gerekir.
CComUnkArray::CComUnkArray
Oluşturucu.
CComUnkArray();
Açıklamalar
İşaretçileri tutacak nMaxSize IUnknown koleksiyonu ayarlar ve işaretçileri NULL olarak başlatır.
CComUnkArray::end
Koleksiyondaki son IUnknown işaretçiyi geçen işaretçiyi döndürür.
IUnknown**
end();
Dönüş Değeri
Arabirim işaretçisine yönelik bir IUnknown işaretçi.
Açıklamalar
CComUnkArray ve end yöntemleribegin, örneğin bir olay tetiklendiğinde tüm bağlantı noktaları arasında döngü yapmak için kullanılabilir.
IUnknown** p = m_vec.begin();
while(p != m_vec.end())
{
// Do something with *p
p++;
}
CComUnkArray::GetCookie
Belirli IUnknown bir işaretçiyle ilişkili tanımlama bilgisini almak için bu yöntemi çağırın.
DWORD WINAPI GetCookie(IUnknown** ppFind);
Parametreler
ppFind
İlişkili IUnknown tanımlama bilgisinin gerekli olduğu işaretçi.
Dönüş Değeri
İşaretçiyle IUnknown ilişkili tanımlama bilgisini veya eşleşen IUnknown bir işaretçi bulunamazsa 0 değerini döndürür.
Açıklamalar
Aynı IUnknown işaretçinin birden fazla örneği varsa, bu işlev ilk işaretçi için tanımlama bilgisini döndürür.
CComUnkArray::GetUnknown
Belirli bir tanımlama bilgisi ile ilişkili işaretçiyi IUnknown almak için bu yöntemi çağırın.
IUnknown* WINAPI GetUnknown(DWORD dwCookie);
Parametreler
dwCookie
İlişkili IUnknown işaretçinin gerekli olduğu tanımlama bilgisi.
Dönüş Değeri
İşaretçiyi IUnknown döndürür veya eşleşen tanımlama bilgisi bulunmazsa NULL döndürür.
CComUnkArray::Remove
Diziden bir IUnknown işaretçiyi kaldırmak için bu yöntemi çağırın.
BOOL Remove(DWORD dwCookie);
Parametreler
dwCookie
Diziden kaldırılacak işaretçiye başvuran IUnknown tanımlama bilgisi.
Dönüş Değeri
İşaretçi kaldırılırsa TRUE, aksi takdirde YANLIŞ döndürür.