CDataPathProperty – třída
Implementuje vlastnost ovládacího prvku OLE, která lze načíst asynchronně.
Syntaxe
class CDataPathProperty : public CAsyncMonikerFile
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CDataPathProperty::CDataPathProperty | CDataPathProperty Vytvoří objekt. |
Veřejné metody
| Název | Popis |
|---|---|
| CDataPathProperty::GetControl | Načte asynchronní ovládací prvek OLE přidružený k objektu CDataPathProperty . |
| CDataPathProperty::GetPath | Načte název cesty vlastnosti. |
| CDataPathProperty::Open | Zahájí načítání asynchronní vlastnosti pro přidružený ovládací prvek ActiveX (OLE). |
| CDataPathProperty::ResetData | Volání CAsyncMonikerFile::OnDataAvailable , která upozorní kontejner, že se změnily vlastnosti ovládacího prvku. |
| CDataPathProperty::SetControl | Nastaví asynchronní ovládací prvek ActiveX (OLE) přidružený k vlastnosti. |
| CDataPathProperty::SetPath | Nastaví název cesty vlastnosti. |
Poznámky
Asynchronní vlastnosti se načtou po synchronním zahájení.
Třída CDataPathProperty je odvozena z CAysncMonikerFile. Chcete-li implementovat asynchronní vlastnosti v ovládacích prvcích OLE, odvodit třídu z CDataPathPropertya přepsat OnDataAvailable.
Další informace o používání asynchronních ovládacích prvků monikers a ovládacích prvků ActiveX v internetových aplikacích najdete v následujících článcích:
Hierarchie dědičnosti
CDataPathProperty
Požadavky
Záhlaví: afxctl.h
CDataPathProperty::CDataPathProperty
CDataPathProperty Vytvoří objekt.
CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);
Parametry
pControl
Ukazatel na objekt ovládacího prvku OLE, který má být přidružen k tomuto CDataPathProperty objektu.
lpszPath
Cesta, která může být absolutní nebo relativní, slouží k vytvoření asynchronního monikeru, který odkazuje na skutečné absolutní umístění vlastnosti. CDataPathProperty používá adresy URL, nikoli názvy souborů. Pokud chcete CDataPathProperty objekt pro soubor, předpřipravený file:// k cestě.
Poznámky
Objekt COleControl odkazovaný na pControl je používán Open a načten pomocí odvozených tříd. Pokud pControl je NULL, ovládací prvek použitý s Open by měl být nastaven s SetControl. Pokud je lpszPath NULL, můžete předat cestu prostřednictvím Open nebo nastavit pomocí SetPath.
CDataPathProperty::GetControl
Voláním této členské funkce načtěte COleControl objekt přidružený k objektu CDataPathProperty .
COleControl* GetControl();
Návratová hodnota
Vrátí ukazatel na ovládací prvek OLE přidružený k objektu CDataPathProperty . Pokud není ovládací prvek přidružen, hodnota NULL je přidružena.
CDataPathProperty::GetPath
Voláním této členské funkce načtěte cestu, nastavte, když CDataPathProperty byl objekt vytvořen nebo zadán v Open, nebo zadaný v předchozím volání SetPath členské funkce.
CString GetPath() const;
Návratová hodnota
Vrátí název cesty k samotné vlastnosti. Pokud nebyla zadána žádná cesta, může být prázdná.
CDataPathProperty::Open
Voláním této členské funkce zahájíte načítání asynchronní vlastnosti přidruženého ovládacího prvku.
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);
Parametry
pControl
Ukazatel na objekt ovládacího prvku OLE, který má být přidružen k tomuto CDataPathProperty objektu.
Chyba pError
Ukazatel na výjimku souboru. V případě chyby se nastaví na příčinu.
lpszPath
Cesta, která může být absolutní nebo relativní, slouží k vytvoření asynchronního monikeru, který odkazuje na skutečné absolutní umístění vlastnosti. CDataPathProperty používá adresy URL, nikoli názvy souborů. Pokud chcete CDataPathProperty objekt pro soubor, předpřipravený file:// k cestě.
Návratová hodnota
Nenulové, pokud je úspěšné; jinak 0.
Poznámky
Funkce se pokusí získat IBindHost rozhraní z ovládacího prvku.
Před voláním Open bez cesty musí být nastavena hodnota cesty vlastnosti. To lze provést při vytvoření objektu nebo voláním SetPath členské funkce.
Před voláním Open bez ovládacího prvku může být k objektu přidružen ovládací prvek ActiveX (dříve označovaný jako ovládací prvek OLE). To lze provést při vytváření objektu nebo voláním SetControl.
Všechna přetížení CAsyncMonikerFile::Open jsou k dispozici také z CDataPathProperty.
CDataPathProperty::ResetData
Voláním této funkce dostanete upozornění CAsyncMonikerFile::OnDataAvailable kontejneru, že se změnily vlastnosti ovládacího prvku a všechny informace načtené asynchronně nejsou užitečné.
virtual void ResetData();
Poznámky
Otevření by se mělo restartovat. Odvozené třídy mohou tuto funkci přepsat pro různé výchozí hodnoty.
CDataPathProperty::SetControl
Voláním této členské funkce přidružíte k objektu CDataPathProperty asynchronní ovládací prvek OLE.
void SetControl(COleControl* pControl);
Parametry
pControl
Ukazatel na asynchronní ovládací prvek OLE, který má být přidružen k vlastnosti.
CDataPathProperty::SetPath
Voláním této členské funkce nastavíte název cesty vlastnosti.
void SetPath(LPCTSTR lpszPath);
Parametry
lpszPath
Cesta, která může být absolutní nebo relativní, k vlastnosti, která se načítá asynchronně. CDataPathProperty používá adresy URL, nikoli názvy souborů. Pokud chcete CDataPathProperty objekt pro soubor, předpřipravený file:// k cestě.
Viz také
Ukázkový obrázek MFC
CAsyncMonikerFile – třída
Graf hierarchie
CAsyncMonikerFile – třída