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


COleControl::OnRenderData

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

virtual BOOL OnRenderData( 
   LPFORMATETC lpFormatEtc, 
   LPSTGMEDIUM lpStgMedium  
);

Параметры

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

  • lpStgMedium
    Указатель на структуру STGMEDIUM, в которой данные необходимо вернуть.

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

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

Заметки

Заданный формат одного ранее помещенное в объекте управления с помощью функций-членов DelayRenderData или DelayRenderFileData для отложенной обработки. Реализация по умолчанию данного вызовы функций OnRenderFileData или OnRenderGlobalData, соответственно, если указанный носитель записи или в файле или памяти. Если запрошенный CF_METAFILEPICT формат или постоянный формат набора свойств, реализация по умолчанию визуализирует соответствующие данные и возвращает ненулевое значение. В противном случае возвращается 0 и не выполняет никаких действий.

Если lpstgmedium->tymedTYMED_NULL, то STGMEDIUM должно быть выделен и заполняется, как определено lpformatetc->tymed. Если не TYMED_NULL, STGMEDIUM должно заполненное в позиционирование с данными.

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

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

Требования

Header: afxctl.h

См. также

Ссылки

Класс COleControl

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

COleControl::OnRenderFileData

COleControl::OnRenderGlobalData