IViewObject2::GetExtent 메서드(oleidl.h)

아티클
08/25/2023

지정된 대상 디바이스에서 지정된 뷰 개체를 그릴 크기를 검색합니다.

구문

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	적절한 캐시를 사용할 수 없습니다.

설명

IViewObject2::GetExtent의 OLE 제공 구현은 캐시에서 뷰 개체의 크기를 검색합니다.

IOleObject 인터페이스의 IOleObject::GetExtent 메서드는 IViewObject2::GetExtent와 동일한 정보를 제공합니다.

이 메서드는 DVASPECT2 모든 새 측면에 대해 DVASPECT_CONTENT 동일한 크기를 반환해야 합니다. IOleObject::GetExtent 는 동일한 작업을 수행해야 합니다.

dwAspect에서 새 측면 중 하나가 요청된 경우 이 메서드는 실패하거나 DVASPECT_CONTENT 측면과 동일한 사각형을 반환할 수 있습니다.

발신자에 대한 참고 사항

개체가 아직 실행되고 있지 않은 경우 개체가 실행되지 않도록 하려면 IOleObject::GetExtent 대신 IViewObject2::GetExtent를 호출하여 그릴 프레젠테이션의 크기를 결정할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	oleidl.h
DLL	Adhocreportingexcelclient.dll