Compartir vía

CDataPathProperty (clase)

  • Artículo

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

CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

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)