Classe CDataPathProperty

Implementa una proprietà del controllo OLE che può essere caricata in modo asincrono.

Sintassi

class CDataPathProperty : public CAsyncMonikerFile

Membri

Costruttori pubblici

Metodi pubblici

Osservazioni:

Le proprietà asincrone vengono caricate dopo l'avvio sincrono.

La classe CDataPathProperty è derivata da CAysncMonikerFile. Per implementare proprietà asincrone nei controlli OLE, derivare una classe da CDataPathPropertyed eseguire l'override di OnDataAvailable.

Per altre informazioni su come usare moniker asincroni e controlli ActiveX nelle applicazioni Internet, vedere gli articoli seguenti:

• Passaggi preliminari su Internet: Controlli ActiveX

• Passaggi preliminari su Internet: Moniker asincroni

Gerarchia di ereditarietà

CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

CDataPathProperty

Requisiti

Intestazione: afxctl.h

CDataPathProperty::CDataPathProperty

Costruisce un oggetto CDataPathProperty.

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

Parametri

pControl
Puntatore all'oggetto controllo OLE da associare a questo CDataPathProperty oggetto.

lpszPath
Percorso, che può essere assoluto o relativo, utilizzato per creare un moniker asincrono che fa riferimento alla posizione assoluta effettiva della proprietà. CDataPathProperty usa GLI URL, non i nomi file. Se si desidera un CDataPathProperty oggetto per un file, anteporre file:// al percorso.

Osservazioni:

L'oggetto COleControl a cui punta pControl viene utilizzato e Open recuperato dalle classi derivate. Se pControl è NULL, il controllo usato con Open deve essere impostato con SetControl. Se lpszPath è NULL, è possibile passare il percorso o Open impostarlo con SetPath.

CDataPathProperty::GetControl

Chiamare questa funzione membro per recuperare l'oggetto COleControl associato all'oggetto CDataPathProperty .

COleControl* GetControl();

Valore restituito

Restituisce un puntatore al controllo OLE associato all'oggetto CDataPathProperty . NULL se non è associato un controllo.

CDataPathProperty::GetPath

Chiamare questa funzione membro per recuperare il percorso, impostare quando l'oggetto CDataPathProperty è stato costruito o specificato in Openo specificato in una chiamata precedente alla SetPath funzione membro.

CString GetPath() const;

Valore restituito

Restituisce il percorso della proprietà stessa. Può essere vuoto se non è stato specificato alcun percorso.

CDataPathProperty::Open

Chiamare questa funzione membro per avviare il caricamento della proprietà asincrona per il controllo associato.

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

Parametri

pControl
Puntatore all'oggetto controllo OLE da associare a questo CDataPathProperty oggetto.

pError
Puntatore a un'eccezione di file. In caso di errore, verrà impostato sulla causa.

lpszPath
Percorso, che può essere assoluto o relativo, utilizzato per creare un moniker asincrono che fa riferimento alla posizione assoluta effettiva della proprietà. CDataPathProperty usa GLI URL, non i nomi file. Se si desidera un CDataPathProperty oggetto per un file, anteporre file:// al percorso.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

La funzione tenta di ottenere l'interfaccia IBindHost dal controllo .

Prima di chiamare Open senza un percorso, è necessario impostare il valore per il percorso della proprietà. Questa operazione può essere eseguita quando l'oggetto viene costruito o chiamando la SetPath funzione membro.

Prima di chiamare Open senza un controllo , un controllo ActiveX (noto in precedenza come controllo OLE) può essere associato all'oggetto . Questa operazione può essere eseguita quando l'oggetto viene costruito o chiamando SetControl.

Tutti gli overload di CAsyncMonikerFile::Open sono disponibili anche da CDataPathProperty.

CDataPathProperty::ResetData

Chiamare questa funzione per ricevere CAsyncMonikerFile::OnDataAvailable una notifica al contenitore che le proprietà del controllo sono state modificate e tutte le informazioni caricate in modo asincrono non sono più utili.

virtual void ResetData();

Osservazioni:

L'apertura deve essere riavviata. Le classi derivate possono eseguire l'override di questa funzione per impostazioni predefinite diverse.

CDataPathProperty::SetControl

Chiamare questa funzione membro per associare un controllo OLE asincrono all'oggetto CDataPathProperty .

void SetControl(COleControl* pControl);

Parametri

pControl
Puntatore al controllo OLE asincrono da associare alla proprietà .

CDataPathProperty::SetPath

Chiamare questa funzione membro per impostare il percorso della proprietà.

void SetPath(LPCTSTR lpszPath);

Parametri

lpszPath
Percorso, che può essere assoluto o relativo, alla proprietà caricata in modo asincrono. CDataPathProperty usa GLI URL, non i nomi file. Se si desidera un CDataPathProperty oggetto per un file, anteporre file:// al percorso.

Vedi anche

Immagine di esempio MFC
Classe CAsyncMonikerFile
Grafico della gerarchia
Classe CAsyncMonikerFile