Classe CDataPathProperty
Implementa una proprietà del controllo OLE che può essere caricata in modo asincrono.
Sintassi
class CDataPathProperty : public CAsyncMonikerFile
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CDataPathProperty::CDataPathProperty | Costruisce un oggetto CDataPathProperty. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CDataPathProperty::GetControl | Recupera il controllo OLE asincrono associato all'oggetto CDataPathProperty . |
| CDataPathProperty::GetPath | Recupera il percorso della proprietà. |
| CDataPathProperty::Open | Avvia il caricamento della proprietà asincrona per il controllo ActiveX (OLE) associato. |
| CDataPathProperty::ResetData | Chiamate CAsyncMonikerFile::OnDataAvailable per notificare al contenitore che le proprietà del controllo sono state modificate. |
| CDataPathProperty::SetControl | Imposta il controllo ActiveX (OLE) asincrono associato alla proprietà . |
| CDataPathProperty::SetPath | Imposta il percorso della proprietà. |
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:
Gerarchia di ereditarietà
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