Метод 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 реализация 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 |