Share via

CDataPathProperty-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Hiermee wordt een OLE-besturingselementeigenschap geïmplementeerd die asynchroon kan worden geladen.

Syntaxis

class CDataPathProperty : public CAsyncMonikerFile

Leden

Openbare constructors

Naam Description
CDataPathProperty::CDataPathProperty Maakt een CDataPathProperty object.

Openbare methoden

Naam Description
CDataPathProperty::GetControl Hiermee wordt het asynchrone OLE-besturingselement opgehaald dat aan het CDataPathProperty object is gekoppeld.
CDataPathProperty::GetPath Haalt de padnaam van de eigenschap op.
CDataPathProperty::Open Hiermee wordt het laden van de asynchrone eigenschap voor het bijbehorende OLE-besturingselement (ActiveX) gestart.
CDataPathProperty::ResetData Aanroepen CAsyncMonikerFile::OnDataAvailable om de container op de hoogte te stellen dat de eigenschappen van het besturingselement zijn gewijzigd.
CDataPathProperty::SetControl Hiermee stelt u het asynchrone OLE-besturingselement (ActiveX) in dat is gekoppeld aan de eigenschap.
CDataPathProperty::SetPath Hiermee stelt u de padnaam van de eigenschap in.

Opmerkingen

Asynchrone eigenschappen worden na synchrone start geladen.

De klasse CDataPathProperty is afgeleid van CAysncMonikerFile. Als u asynchrone eigenschappen in uw OLE-besturingselementen wilt implementeren, moet u een klasse afleiden van CDataPathPropertyen onDataAvailable overschrijven.

Zie de volgende artikelen voor meer informatie over het gebruik van asynchrone monikers en ActiveX-besturingselementen in internettoepassingen:

Overnamehiërarchie

CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

CDataPathProperty

Requirements

Koptekst: afxctl.h

CDataPathProperty::CDataPathProperty

Maakt een CDataPathProperty object.

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

Parameterwaarden

pControl
Een aanwijzer naar het OLE-besturingsobject dat aan dit CDataPathProperty object moet worden gekoppeld.

lpszPath
Het pad, dat absoluut of relatief kan zijn, wordt gebruikt om een asynchrone moniker te maken die verwijst naar de werkelijke absolute locatie van de eigenschap. CDataPathProperty gebruikt URL's, geen bestandsnamen. Als u een CDataPathProperty object voor een bestand wilt, gaat file:// u naar het pad.

Opmerkingen

Het COleControl object waarnaar wordt verwezen door pControl wordt gebruikt Open en opgehaald door afgeleide klassen. Als pControl NULL is, moet het besturingselement waarmee wordt gebruikt Open , worden ingesteld met SetControl. Als lpszPath NULL is, kunt u het pad doorgeven Open of instellen met SetPath.

CDataPathProperty::GetControl

Roep deze lidfunctie aan om het COleControl object op te halen dat aan het CDataPathProperty object is gekoppeld.

COleControl* GetControl();

Retourwaarde

Hiermee wordt een aanwijzer geretourneerd naar het OLE-besturingselement dat aan het CDataPathProperty object is gekoppeld. NULL als er geen besturingselement is gekoppeld.

CDataPathProperty::GetPath

Roep deze lidfunctie aan om het pad op te halen, in te stellen wanneer het CDataPathProperty object is gemaakt of opgegeven in Open, of opgegeven in een eerdere aanroep naar de SetPath lidfunctie.

CString GetPath() const;

Retourwaarde

Retourneert de padnaam naar de eigenschap zelf. Kan leeg zijn als er geen pad is opgegeven.

CDataPathProperty::Open

Roep deze lidfunctie aan om het laden van de asynchrone eigenschap voor het bijbehorende besturingselement te starten.

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);

Parameterwaarden

pControl
Een aanwijzer naar het OLE-besturingsobject dat aan dit CDataPathProperty object moet worden gekoppeld.

pError
Een aanwijzer naar een bestandsonderzondering. In het geval van een fout wordt deze ingesteld op de oorzaak.

lpszPath
Het pad, dat absoluut of relatief kan zijn, wordt gebruikt om een asynchrone moniker te maken die verwijst naar de werkelijke absolute locatie van de eigenschap. CDataPathProperty gebruikt URL's, geen bestandsnamen. Als u een CDataPathProperty object voor een bestand wilt, gaat file:// u naar het pad.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

De functie probeert de IBindHost interface van het besturingselement te verkrijgen.

Voordat u zonder pad aanroept Open , moet de waarde voor het pad van de eigenschap worden ingesteld. Dit kan worden gedaan wanneer het object is samengesteld of door de SetPath lidfunctie aan te roepen.

Voordat u zonder besturingselement aanroept Open , kan een ActiveX-besturingselement (voorheen ole-besturingselement genoemd) aan het object worden gekoppeld. Dit kan worden gedaan wanneer het object is samengesteld of door aan te roepen SetControl.

Alle overbelastingen van CAsyncMonikerFile::Open zijn ook beschikbaar van CDataPathProperty.

CDataPathProperty::ResetData

Roep deze functie aan om de container te CAsyncMonikerFile::OnDataAvailable informeren dat de eigenschappen van het besturingselement zijn gewijzigd en dat alle informatie die asynchroon is geladen, niet meer nuttig is.

virtual void ResetData();

Opmerkingen

Openen moet opnieuw worden gestart. Afgeleide klassen kunnen deze functie overschrijven voor verschillende standaardwaarden.

CDataPathProperty::SetControl

Roep deze lidfunctie aan om een asynchroon OLE-besturingselement aan het CDataPathProperty object te koppelen.

void SetControl(COleControl* pControl);

Parameterwaarden

pControl
Een aanwijzer naar het asynchrone OLE-besturingselement dat aan de eigenschap moet worden gekoppeld.

CDataPathProperty::SetPath

Roep deze lidfunctie aan om de padnaam van de eigenschap in te stellen.

void SetPath(LPCTSTR lpszPath);

Parameterwaarden

lpszPath
Een pad, dat absoluut of relatief kan zijn, naar de eigenschap die asynchroon wordt geladen. CDataPathProperty gebruikt URL's, geen bestandsnamen. Als u een CDataPathProperty object voor een bestand wilt, gaat file:// u naar het pad.

Zie ook

Voorbeeldafbeelding van MFC
Klasse CAsyncMonikerFile
Hiërarchiegrafiek
Klasse CAsyncMonikerFile

  • Last updated on