CComDynamicUnkArray osztály

Megjegyzés:

Az aktív sablontár (ATL) továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Ez az osztály egy mutatótömböt IUnknown tárol.

Szemantika

class CComDynamicUnkArray

Tagok

Nyilvános konstruktorok

Név	Description
CComDynamicUnkArray::CComDynamicUnkArray	Konstruktor. A gyűjtemény értékeit NULL értékre inicializálja, a gyűjtemény méretét pedig nullára.
CComDynamicUnkArray::~CComDynamicUnkArray	A destruktor.

Nyilvános módszerek

Név	Description
CComDynamicUnkArray::Add	Hívja meg ezt a metódust, ha mutatót IUnknown szeretne hozzáadni a tömbhöz.
CComDynamicUnkArray::begin	Egy mutatót a gyűjtemény első IUnknown mutatójának ad vissza.
CComDynamicUnkArray::clear	Kiüríti a tömböt.
CComDynamicUnkArray::end	Egy mutatót a gyűjtemény utolsó IUnknown mutatója fölé ad vissza.
CComDynamicUnkArray::GetAt	Lekéri az elemet a megadott indexben.
CComDynamicUnkArray::GetCookie	Hívja meg ezt a metódust, hogy lekérje az adott mutatóhoz társított cookie-t IUnknown .
CComDynamicUnkArray::GetSize	A tömb által tárolható elemek számát adja vissza.
CComDynamicUnkArray::GetUnknown	Hívja meg ezt a metódust egy IUnknown adott cookie-hoz társított mutató lekéréséhez.
CComDynamicUnkArray::Remove	Hívja meg ezt a metódust, hogy eltávolítson egy mutatót IUnknown a tömbből.

Megjegyzések

CComDynamicUnkArray egy dinamikusan lefoglalt mutatótömböt IUnknown tartalmaz, amelyek mindegyike egy csatlakozási ponton található interfész. CComDynamicUnkArray paraméterként használható az IConnectionPointImpl sablonosztályhoz.

A CComDynamicUnkArraymetódusok az összes csatlakozási ponton (például egy esemény aktiválásakor) végigcsukhatók.

A csatlakozási pont-proxyk létrehozásának automatizálásával kapcsolatos részletekért lásd: Csatlakozási pontok hozzáadása objektumhoz .

Megjegyzés:

Megjegyzés Az osztályt CComDynamicUnkArray az Osztály hozzáadása varázsló használja egy kapcsolati pontokkal rendelkező vezérlőelem létrehozásakor. Ha manuálisan szeretné megadni a csatlakozási pontok számát, módosítsa a hivatkozást n-ről n-re>CComDynamicUnkArrayCComUnkArray<, ahol n a szükséges csatlakozási pontok száma.

Requirements

Fejléc: atlcom.h

CComDynamicUnkArray::Add

Hívja meg ezt a metódust, ha mutatót IUnknown szeretne hozzáadni a tömbhöz.

DWORD Add(IUnknown* pUnk);

Paraméterek

Punk
A IUnknown tömbhöz hozzáadni kívánt mutató.

Visszaadott érték

Az újonnan hozzáadott mutatóhoz társított cookie-t adja vissza. Ezzel a cookie-val lekérheti a mutatót a tömbből a CComDynamicUnkArray::GetAt használatával.

Megjegyzések

Az elem beszúrási helye nem feltétlenül lesz közvetlenül az utolsó beszúrt elem után, ha Remove() korábban erre a tömbre hívták. A visszaadott cookie használatával megbízhatóan elérheti a beszúrt mutatót. A tömb mérete több elem elhelyezésére növelhető. Az új méret lekérésére használható GetSize() .

CComDynamicUnkArray::begin

Az illesztőmutatók gyűjteményének IUnknown elejére mutató mutatót ad vissza.

IUnknown**
    begin();

Visszaadott érték

Egy illesztőmutatóra IUnknown mutató mutató.

Megjegyzések

A gyűjtemény a helyileg IUnknowntárolt felületek mutatóit tartalmazza. Minden IUnknown illesztőt a valódi felülettípusra vet, majd meghívja azt. Először nem kell lekérdeznie a felületet.

A felület használata IUnknown előtt ellenőrizze, hogy nem NULL értékű-e.

CComDynamicUnkArray::clear

Kiüríti a tömböt. Alaphelyzetbe állítja a méretet 0-ra.

void clear();

CComDynamicUnkArray::CComDynamicUnkArray

A konstruktor.

CComDynamicUnkArray();

Megjegyzések

A gyűjtemény méretét nullára állítja, és az értékeket NULL értékre inicializálja. A destruktor szükség esetén felszabadítja a gyűjteményt.

CComDynamicUnkArray::~CComDynamicUnkArray

A destruktor.

~CComDynamicUnkArray();

Megjegyzések

Felszabadítja az osztálykonstruktor által lefoglalt erőforrásokat.

CComDynamicUnkArray::end

Egy mutatót ad vissza a tömb lefoglalt pufferének utolsó eleméhez.

Megjegyzés: ez azt jelenti, hogy az utolsóként beszúrt mutató nem biztos, hogy a end()-1 helyén van, mert előfordulhat, hogy a tömb nem tölthető ki kapacitással.

IUnknown**
    end();

Visszaadott érték

Egy illesztőmutatóra IUnknown mutató mutató.

CComDynamicUnkArray::GetAt

Lekéri az elemet a megadott indexben.

IUnknown* GetAt(int nIndex);

Paraméterek

nIndex
A lekérni kívánt elem indexe.

Visszaadott érték

Egy IUnknown felületre mutató mutató, ha korábban hozzáadtak egy elemet, és ezen az indexen található; egyéb esetben NULL.

CComDynamicUnkArray::GetCookie

Hívja meg ezt a metódust, hogy lekérje az adott mutatóhoz társított cookie-t IUnknown .

DWORD WINAPI GetCookie(IUnknown** ppFind);

Paraméterek

ppFind
Az IUnknown a mutató, amelyhez a társított cookie szükséges.

Visszaadott érték

A mutatóhoz IUnknown társított cookie-t adja vissza, vagy nullát, ha nem található egyező IUnknown mutató.

Megjegyzések

Ha ugyanannak IUnknown a mutatónak több példánya is van, ez a függvény az elsőhöz tartozó cookie-t adja vissza.

CComDynamicUnkArray::GetSize

A tömb lefoglalt kapacitását adja vissza.

Megjegyzés: ez nem ugyanaz, mint a tömbben jelenleg nem null értékű elemek száma.

int GetSize() const;

Visszaadott érték

A tömb által tárolható elemek száma. GetSize() == end() - begin().

CComDynamicUnkArray::GetUnknown

Hívja meg ezt a metódust egy IUnknown adott cookie-hoz társított mutató lekéréséhez.

IUnknown* WINAPI GetUnknown(DWORD dwCookie);

Paraméterek

dwCookie
Az a cookie, amelyhez a társított IUnknown mutató szükséges.

Visszaadott érték

IUnknown A mutatót vagy NULL értéket adja vissza, ha nem található egyező cookie.

CComDynamicUnkArray::Remove

Hívja meg ezt a metódust, hogy eltávolítson egy mutatót IUnknown a tömbből.

Minden más elem változatlan marad, és megtartja az indexet és a cookie-t.

BOOL Remove(DWORD dwCookie);

Paraméterek

dwCookie
A tömbből eltávolítandó mutatóra hivatkozó IUnknown cookie.

Visszaadott érték

IGAZ értéket ad vissza, ha a mutató el lett távolítva; egyéb esetben HAMIS.

Lásd még

CComUnkArray osztály
osztály áttekintése