COleDataSource::CacheData

void CacheData ( CLIPFORMAT cfFormat, LPSTGMEDIUM lpStgMedium, LPFORMATETC lpFormatEtc = NULL );

Параметры

cfFormat

Формат буфера обмена, в котором данные должен предлагаться. Этот параметр может быть один из предопределенных форматов буфера обмена или значение, возвращаемое родной Windows RegisterClipboardFormat функция.

lpStgMedium

Указывает на структуре STGMEDIUM , содержащий данные в указанном формате.

lpFormatEtc

Указывает на структура FORMATETC , описывающие формат, в котором данные должен предлагаться. Укажите значение для этого параметра, если вы хотите задать дополнительные сведения за пределами формат буфера обмена, предусмотренных cfFormat. Если это значение NULL, используются значения по умолчанию для полей в структуре FORMATETC.

Примечания

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

Поставки данных с помощью структуре STGMEDIUM . Можно использовать функцию-член CacheGlobalData , если объем данных, который указан является достаточно небольшим, чтобы быть переведены, эффективно используя HGLOBAL.nbsp;

После вызова CacheData объект данных, не вызывающей стороной являются собственностью ptd член lpFormatEtc и содержание lpStgMedium.

Чтобы использовать задержек рендеринга, вызовите функцию-член DelayRenderData или DelayRenderFileData . Дополнительную информацию о отложенной визуализации как обработанное MFC, можно найти в статье объекты данных и источников данных: манипуляция в Руководстве по Visual C++ программист.

Для получения дополнительной информации, смотрите STGMEDIUM и FORMATETC структуры в 2 справочнике программиста OLE, том 1.

Для получения дополнительной информации, смотрите RegisterClipboardFormat в документации Win32.

Обзор COleDataSourceЧлены класса | Иерархическая схема

См. также COleDataSource::CacheGlobalData, COleDataSource::DelayRenderData, COleDataSource::DelayRenderFileData, COleDataSource::SetClipboard, COleDataSource::DoDragDrop

Index