Класс 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 в интернет-приложениях см. в следующих статьях:
Иерархия наследования
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
Вызовите эту функцию-член, чтобы получить объект, связанный COleControl CDataPathProperty с объектом.
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