Поделиться через

Класс CDataPathProperty

  • Статья

Реализует свойство элемента управления OLE, которое можно загрузить асинхронно.

Синтаксис

class CDataPathProperty : public CAsyncMonikerFile

Участники

Открытые конструкторы

Имя Описание
CDataPathProperty::CDataPathProperty Формирует объект CDataPathProperty.

Открытые методы

Имя Описание
CDataPathProperty::GetControl Извлекает асинхронный элемент управления OLE, связанный CDataPathProperty с объектом.
CDataPathProperty::GetPath Извлекает имя пути свойства.
CDataPathProperty::Open Инициирует загрузку асинхронного свойства для связанного элемента управления ActiveX (OLE).
CDataPathProperty::ResetData Вызовы CAsyncMonikerFile::OnDataAvailable для уведомления контейнера о том, что свойства элемента управления изменились.
CDataPathProperty::SetControl Задает асинхронный элемент управления ActiveX (OLE), связанный со свойством.
CDataPathProperty::SetPath Задает имя пути свойства.

Замечания

Асинхронные свойства загружаются после синхронного запуска.

Класс CDataPathProperty является производным от CAysncMonikerFile. Чтобы реализовать асинхронные свойства в элементах управления OLE, наследуйте класс из CDataPathPropertyи переопределите OnDataAvailable.

Дополнительные сведения об использовании асинхронных моникеров и элементов ActiveX в интернет-приложениях см. в следующих статьях:

Иерархия наследования

CObject

Cfile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

CDataPathProperty

Требования

Заголовок: afxctl.h

CDataPathProperty::CDataPathProperty

Формирует объект CDataPathProperty.

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

Параметры

pControl
Указатель на объект управления OLE, связанный с этим CDataPathProperty объектом.

lpszPath
Путь, который может быть абсолютным или относительным, используется для создания асинхронного моникера, который ссылается на фактическое абсолютное расположение свойства. CDataPathProperty использует URL-адреса, а не имена файлов. Если требуется CDataPathProperty объект для файла, предустановленный file:// в путь.

Замечания

COleControl Объект, на который указывает pControl, используется и извлекается производными Open классами. Если pControl имеет значение NULL, то элемент управления, используемый с Open ним, должен иметь значение SetControl. Если lpszPath имеет значение NULL, можно передать путь Open через или задать его.SetPath

CDataPathProperty::GetControl

Вызовите эту функцию-член, чтобы получить объект, связанный COleControlCDataPathProperty с объектом.

COleControl* GetControl();

Возвращаемое значение

Возвращает указатель на элемент управления OLE, связанный с CDataPathProperty объектом. Значение NULL, если элемент управления не связан.

CDataPathProperty::GetPath

Вызовите эту функцию-член, чтобы получить путь, задать, когда CDataPathProperty объект был создан или указан Openв или указан в предыдущем вызове SetPath функции-члена.

CString GetPath() const;

Возвращаемое значение

Возвращает имя пути к самому свойству. Может быть пустым, если путь не указан.

CDataPathProperty::Open

Вызовите эту функцию-член, чтобы инициировать загрузку асинхронного свойства для связанного элемента управления.

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

Параметры

pControl
Указатель на объект управления OLE, связанный с этим CDataPathProperty объектом.

pError
Указатель на исключение файла. В случае ошибки будет задана причина.

lpszPath
Путь, который может быть абсолютным или относительным, используется для создания асинхронного моникера, который ссылается на фактическое абсолютное расположение свойства. CDataPathProperty использует URL-адреса, а не имена файлов. Если требуется CDataPathProperty объект для файла, предустановленный file:// в путь.

Возвращаемое значение

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

Функция пытается получить IBindHost интерфейс из элемента управления.

Перед вызовом Open без пути необходимо задать значение для пути свойства. Это можно сделать при построении объекта или вызове SetPath функции-члена.

Перед вызовом Open без элемента управления элемент ActiveX (ранее известный как элемент управления OLE) можно связать с объектом. Это можно сделать при построении объекта или вызове SetControl.

Все перегрузки CAsyncMonikerFile::Open также доступны.CDataPathProperty

CDataPathProperty::ResetData

Вызовите эту функцию, чтобы получить CAsyncMonikerFile::OnDataAvailable уведомление о том, что свойства элемента управления изменились, и все данные, загруженные асинхронно, больше не полезны.

virtual void ResetData();

Замечания

Открытие должно быть перезапущено. Производные классы могут переопределить эту функцию для разных значений по умолчанию.

CDataPathProperty::SetControl

Вызовите эту функцию-член, чтобы связать асинхронный элемент управления OLE с CDataPathProperty объектом.

void SetControl(COleControl* pControl);

Параметры

pControl
Указатель на асинхронный элемент управления OLE, связанный с свойством.

CDataPathProperty::SetPath

Вызовите эту функцию-член, чтобы задать имя пути свойства.

void SetPath(LPCTSTR lpszPath);

Параметры

lpszPath
Путь, который может быть абсолютным или относительным, к свойству, загружаемому асинхронно. CDataPathProperty использует URL-адреса, а не имена файлов. Если требуется CDataPathProperty объект для файла, предустановленный file:// в путь.

См. также

Образец MFC
Класс CAsyncMonikerFile
Диаграмма иерархии
Класс CAsyncMonikerFile