CDataPathProperty (clase)
Implementa una propiedad de control OLE que se puede cargar de forma asincrónica.
Sintaxis
class CDataPathProperty : public CAsyncMonikerFile
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CDataPathProperty::CDataPathProperty | Construye un objeto CDataPathProperty. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CDataPathProperty::GetControl | Recupera el control OLE asincrónico asociado al objeto CDataPathProperty. |
| CDataPathProperty::GetPath | Recupera el nombre de ruta de acceso de la propiedad. |
| CDataPathProperty::Open | Inicia la carga de la propiedad asincrónica para el control ActiveX (OLE) asociado. |
| CDataPathProperty::ResetData | Llama a CAsyncMonikerFile::OnDataAvailable para notificar al contenedor que las propiedades de control han cambiado. |
| CDataPathProperty::SetControl | Establece el control ActiveX asincrónico (OLE) asociado a la propiedad. |
| CDataPathProperty::SetPath | Establece el nombre de ruta de acceso de la propiedad. |
Comentarios
Las propiedades asincrónicas se cargan después de la iniciación sincrónica.
La clase CDataPathProperty se deriva de CAysncMonikerFile. Para implementar propiedades asincrónicas en los controles OLE, derive una clase de CDataPathProperty e invalide OnDataAvailable.
Para más información sobre cómo usar monikers asincrónicos y controles ActiveX en aplicaciones de Internet, consulte los artículos siguientes:
Jerarquía de herencia
CDataPathProperty
Requisitos
Encabezado: afxctl.h
CDataPathProperty::CDataPathProperty
Construye un objeto CDataPathProperty.
CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);
Parámetros
pControl
Puntero al objeto de control OLE que se va a asociar a este objeto CDataPathProperty.
lpszPath
Ruta de acceso, que puede ser absoluta o relativa, usada para crear un moniker asincrónico que haga referencia a la ubicación absoluta real de la propiedad. CDataPathProperty usa direcciones URL, no nombres de archivo. Si quiere un objeto CDataPathProperty para un archivo, anteponga file:// a la ruta de acceso.
Comentarios
El objeto COleControl al que apunta pControl se usa en Open y lo recuperan las clases derivadas. Si pControl es NULL, el control usado con Open debe establecerse con SetControl. Si lpszPath es NULL, puede pasar la ruta de acceso a través de Open o establecerla con SetPath.
CDataPathProperty::GetControl
Llame a esta función miembro para recuperar el objeto COleControl asociado al objeto CDataPathProperty.
COleControl* GetControl();
Valor devuelto
Devuelve un puntero al control OLE asociado al objeto CDataPathProperty. NULL si no está asociado el control.
CDataPathProperty::GetPath
Llame a esta función miembro para recuperar la ruta de acceso, establecer cuándo se construyó el objeto CDataPathProperty o se especificó en Open, o se especificó en una llamada anterior a la función miembro SetPath.
CString GetPath() const;
Valor devuelto
Devuelve el nombre de ruta de acceso a la propia propiedad. Puede estar vacío si no se ha especificado ninguna ruta de acceso.
CDataPathProperty::Open
Llame a esta función miembro para iniciar la carga de la propiedad asincrónica para el control asociado.
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);
Parámetros
pControl
Puntero al objeto de control OLE que se va a asociar a este objeto CDataPathProperty.
pError
Puntero a una excepción de archivo. En caso de error, se establecerá en la causa.
lpszPath
Ruta de acceso, que puede ser absoluta o relativa, usada para crear un moniker asincrónico que haga referencia a la ubicación absoluta real de la propiedad. CDataPathProperty usa direcciones URL, no nombres de archivo. Si quiere un objeto CDataPathProperty para un archivo, anteponga file:// a la ruta de acceso.
Valor devuelto
Si es correcta, su valor es distinto de cero. En caso contrario, es cero.
Comentarios
La función intenta obtener la interfaz IBindHost del control.
Antes de llamar a Open sin una ruta de acceso, se debe establecer el valor de la ruta de acceso de la propiedad. Esto se puede hacer cuando se construye el objeto o llamando a la función miembro SetPath.
Antes de llamar a Open sin un control, se puede asociar un control ActiveX (anteriormente conocido como control OLE) al objeto. Esto se puede hacer cuando se construye el objeto o llamando a SetControl.
Todas las sobrecargas de CAsyncMonikerFile::Open también están disponibles en CDataPathProperty.
CDataPathProperty::ResetData
Llame a esta función para que CAsyncMonikerFile::OnDataAvailable notifique al contenedor de que las propiedades de control han cambiado y que toda la información cargada de forma asincrónica ya no es útil.
virtual void ResetData();
Comentarios
Se debe reiniciar la apertura. Las clases derivadas pueden invalidar esta función para distintos valores predeterminados.
CDataPathProperty::SetControl
Llame a esta función miembro para asociar un control OLE asincrónico con el objeto CDataPathProperty.
void SetControl(COleControl* pControl);
Parámetros
pControl
Puntero al control OLE asincrónico que se va a asociar a la propiedad.
CDataPathProperty::SetPath
Llame a esta función miembro para establecer el nombre de ruta de acceso de la propiedad.
void SetPath(LPCTSTR lpszPath);
Parámetros
lpszPath
Ruta de acceso, que puede ser absoluta o relativa, a la propiedad que se carga de forma asincrónica. CDataPathProperty usa direcciones URL, no nombres de archivo. Si quiere un objeto CDataPathProperty para un archivo, anteponga file:// a la ruta de acceso.
Consulte también
Imagen de ejemplo de MFC
CAsyncMonikerFile (clase)
Gráfico de jerarquías
CAsyncMonikerFile (clase)