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

Класс CDataPathProperty

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Реализует свойство элемента управления 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

  • Last updated on