CDataPathProperty osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Implementál egy OLE vezérlőtulajdonságot, amely aszinkron módon tölthető be.

Szemantika

class CDataPathProperty : public CAsyncMonikerFile

Tagok

Nyilvános konstruktorok

Név Description
CDataPathProperty::CDataPathProperty Egy CDataPathProperty objektumot hoz létre.

Nyilvános metódusok

Név Description
CDataPathProperty::GetControl Lekéri az objektumhoz társított aszinkron OLE-vezérlőt CDataPathProperty .
CDataPathProperty::GetPath Lekéri a tulajdonság elérési útját.
CDataPathProperty::Megnyitás A társított ActiveX (OLE) vezérlőelem aszinkron tulajdonságának betöltését kezdeményezi.
CDataPathProperty::ResetData Hívások CAsyncMonikerFile::OnDataAvailable a tároló értesítésére, hogy a vezérlő tulajdonságai megváltoztak.
CDataPathProperty::SetControl Beállítja a tulajdonsághoz társított aszinkron ActiveX (OLE) vezérlőt.
CDataPathProperty::SetPath Beállítja a tulajdonság elérési útját.

Megjegyzések

Az aszinkron tulajdonságok a szinkron kezdeményezés után töltődnek be.

Az osztály CDataPathProperty a következőből CAysncMonikerFileszármazik: . Az aszinkron tulajdonságok OLE-vezérlőkben való implementálásához származtatassunk egy osztályt az OnDataAvailable parancsbólCDataPathProperty, és felülbíráljuk azt.

Az aszinkron monikerek és ActiveX-vezérlők internetes alkalmazásokban való használatáról az alábbi cikkekben talál további információt:

Öröklési hierarchia

CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

CDataPathProperty

Requirements

Fejléc: afxctl.h

CDataPathProperty::CDataPathProperty

Egy CDataPathProperty objektumot hoz létre.

CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);

Paraméterek

pControl
Az objektumhoz CDataPathProperty társítandó OLE vezérlőobjektum mutatója.

lpszPath
Az abszolút vagy relatív elérési út egy aszinkron moniker létrehozásához használható, amely a tulajdonság tényleges abszolút helyére hivatkozik. CDataPathProperty URL-címeket használ, nem fájlneveket. Ha objektumot CDataPathProperty szeretne egy fájlhoz, akkor az elérési útra kell előre felfűznie file:// .

Megjegyzések

A COleControlpControl által mutatott objektumot származtatott osztályok használják Open és kérik le. Ha a pControl NULL értékű, akkor a használt vezérlőt Open a következővel SetControlkell beállítani: . Ha az lpszPath NULL értékű, az elérési utat Open átadhatja, vagy beállíthatja a következővel SetPath: .

CDataPathProperty::GetControl

Hívja meg ezt a tagfüggvényt az COleControl objektumhoz társított objektum lekéréséhez CDataPathProperty .

COleControl* GetControl();

Visszaadott érték

Az objektumhoz társított OLE-vezérlőre mutató mutatót CDataPathProperty ad vissza. NULL érték, ha nincs vezérlőelem társítva.

CDataPathProperty::GetPath

Hívja meg ezt a tagfüggvényt a tagfüggvény előző hívásában megadott elérési út lekéréséhez, az CDataPathProperty objektum létrehozásának vagy megadásának Openidőpontjához SetPath .

CString GetPath() const;

Visszaadott érték

A tulajdonság elérési útját adja vissza. Üres lehet, ha nincs megadva elérési út.

CDataPathProperty::Megnyitás

Ennek a tagfüggvénynek a meghívásával kezdeményezheti a társított vezérlőelem aszinkron tulajdonságának betöltését.

virtual BOOL Open(
    COleControl* pControl,
    CFileException* pError = NULL);

virtual BOOL Open(
    LPCTSTR lpszPath,
    COleControl* pControl,
    CFileException* pError = NULL);

virtual BOOL Open(
    LPCTSTR lpszPath,
    CFileException* pError = NULL);

virtual BOOL Open(CFileException* pError = NULL);

Paraméterek

pControl
Az objektumhoz CDataPathProperty társítandó OLE vezérlőobjektum mutatója.

pError
Egy fájlkivételre mutató mutató. Hiba esetén a rendszer az okra állítja be a hibát.

lpszPath
Az abszolút vagy relatív elérési út egy aszinkron moniker létrehozásához használható, amely a tulajdonság tényleges abszolút helyére hivatkozik. CDataPathProperty URL-címeket használ, nem fájlneveket. Ha objektumot CDataPathProperty szeretne egy fájlhoz, akkor az elérési útra kell előre felfűznie file:// .

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A függvény megpróbálja beolvasni az interfészt IBindHost a vezérlőből.

Mielőtt elérési út nélkül hívna Open , be kell állítani a tulajdonság elérési útjának értékét. Ez az objektum létrehozásakor vagy a SetPath tagfüggvény meghívásával végezhető el.

Mielőtt vezérlő nélkül hívna Open , egy ActiveX-vezérlő (korábbi nevén OLE-vezérlő) társítható az objektumhoz. Ez az objektum létrehozásakor vagy hívással SetControlis elvégezhető.

A CAsyncMonikerFile::Open összes túlterhelése elérhető a következőből CDataPathProperty: .

CDataPathProperty::ResetData

Hívja meg ezt a függvényt, hogy CAsyncMonikerFile::OnDataAvailable értesítse a tárolót arról, hogy a vezérlő tulajdonságai megváltoztak, és az aszinkron módon betöltött összes információ már nem hasznos.

virtual void ResetData();

Megjegyzések

A megnyitást újra kell indítani. A származtatott osztályok különböző alapértelmezett értékek esetén felülbírálhatják ezt a függvényt.

CDataPathProperty::SetControl

A tagfüggvény meghívásával aszinkron OLE-vezérlőt társíthat az CDataPathProperty objektumhoz.

void SetControl(COleControl* pControl);

Paraméterek

pControl
A tulajdonsághoz társítandó aszinkron OLE-vezérlőre mutató mutató.

CDataPathProperty::SetPath

Hívja meg ezt a tagfüggvényt a tulajdonság elérési útnevének beállításához.

void SetPath(LPCTSTR lpszPath);

Paraméterek

lpszPath
Az aszinkron módon betöltött tulajdonság abszolút vagy relatív elérési útja. CDataPathProperty URL-címeket használ, nem fájlneveket. Ha objektumot CDataPathProperty szeretne egy fájlhoz, akkor az elérési útra kell előre felfűznie file:// .

Lásd még

MFC-mintakép
CAsyncMonikerFile osztály
hierarchiadiagram
CAsyncMonikerFile osztály

  • Last updated on