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


COleControl::OnRenderGlobalData

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

virtual BOOL OnRenderGlobalData( 
   LPFORMATETC lpFormatEtc, 
   HGLOBAL* phGlobal  
);

Параметры

  • lpFormatEtc
    Указатель на структуру FORMATETC, определяющий формат, в котором запрашиваются сведения.

  • phGlobal
    Указатель на дескриптор к глобальной памяти, в которой данные необходимо вернуть. Если память не была выделена, то этот параметр может быть NULL.

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

Ненулевой, если успешно; в противном случае – значение 0.

Заметки

Заданный формат одного ранее помещенное в объекте управления с помощью функции-члена DelayRenderData для отложенной обработки. Реализация по умолчанию просто возвращает FALSE этой функции.

Если phGlobalNULL, то новое HGLOBAL должно быть выделен и возвращается в phGlobal. В противном случае - значение HGLOBAL указанный phGlobal должно быть заполнено с данными. Количество данных, помещенных в HGLOBAL не должен превышать текущий размер блока памяти. Кроме того, нельзя reallocated к крупноразмерному.

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

Дополнительные сведения см. в разделе макет FORMATETC в Windows SDK.

Требования

Header: afxctl.h

См. также

Ссылки

Класс COleControl

Диаграмма иерархии

COleControl::OnRenderFileData

COleControl::OnRenderData