Метод IViewObject2::GetExtent (oleidl.h)

Извлекает размер указанного объекта представления на указанном целевом устройстве.

Синтаксис

HRESULT GetExtent(
  [in]  DWORD          dwDrawAspect,
  [in]  LONG           lindex,
  [in]  DVTARGETDEVICE *ptd,
  [out] LPSIZEL        lpsizel
);

Параметры

[in] dwDrawAspect

Запрошенное представление объекта с требуемым размером. Возможные значения берутся из перечислений DVASPECT и DVASPECT2 . Обратите внимание, что новые объекты и контейнеры, поддерживающие оптимизированные интерфейсы рисования, поддерживают значения перечисления DVASPECT2 . Старые объекты и контейнеры, которые не поддерживают оптимизированные интерфейсы рисования, могут не поддерживать DVASPECT2.

[in] lindex

Часть объекта, представляющая интерес. В настоящее время единственным возможным значением является -1.

[in] ptd

Указатель на структуру DVTARGETDEVICE , определяющую целевое устройство, для которого должен быть возвращен размер объекта.

[out] lpsizel

Указатель на то, где возвращается размер объекта.

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

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
OLE_E_BLANK	Соответствующий кэш недоступен.

Комментарии

Предоставленная OLE реализация IViewObject2::GetExtent выполняет поиск размера объекта представления в кэше.

Метод IOleObject::GetExtent в интерфейсе IOleObject предоставляет те же сведения, что и IViewObject2::GetExtent.

Этот метод должен возвращать тот же размер, что и DVASPECT_CONTENT для всех новых аспектов в DVASPECT2. IOleObject::GetExtent должен сделать то же самое.

Если в dwAspect запрашивается один из новых аспектов, этот метод может либо завершиться ошибкой, либо вернуть тот же прямоугольник, что и для DVASPECT_CONTENT аспекта.

Примечания к вызывающим абонентам

Чтобы предотвратить запуск объекта, если он еще не запущен, можно вызвать IViewObject2::GetExtent , а не IOleObject::GetExtent , чтобы определить размер отрисовываемой презентации.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	oleidl.h
DLL	Adhocreportingexcelclient.dll

См. также раздел

DVASPECT

DVASPECT2

IOleObject::GetExtent

IViewObject

IViewObject2