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

아티클
03/13/2024

실행 중인 개체의 현재 표시 크기를 검색합니다.

구문

HRESULT GetExtent(
  [in]  DWORD dwDrawAspect,
  [out] SIZEL *psizel
);

매개 변수

[in] dwDrawAspect

제한을 검색할 개체의 측면입니다. 값은 열거형 DVASPECT 및 DVASPECT2 가져옵니다. 최적화된 그리기 인터페이스를 지원하는 최신 개체 및 컨테이너는 DVASPECT2 열거형 값을 지원합니다. 최적화된 그리기 인터페이스를 지원하지 않는 이전 개체 및 컨테이너는 DVASPECT2 지원하지 않을 수 있습니다. 이 메서드의 가장 일반적인 값은 컨테이너 내에서 개체의 전체 렌더링을 지정하는 DVASPECT_CONTENT.

[out] psizel

개체의 크기를 반환할 위치에 대한 포인터입니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 가능한 다른 반환 값은 다음과 같습니다.

반환 코드	설명
E_INVALIDARG	제공된 dwDrawAspect 값이 잘못되었습니다.

설명

컨테이너는 실행 중인 개체 에서 IOleObject::GetExtent 를 호출하여 현재 표시 크기를 검색합니다. 컨테이너가 해당 크기를 수용할 수 있는 경우 개체가 컨테이너보다 더 나은 크기를 알고 있기 때문에 일반적으로 이 작업을 수행합니다. 컨테이너는 일반적으로 개체 초기화의 일부로 이 호출을 수행합니다.

IOleObject::GetExtent에서 반환된 표시 크기는 IOleObject::SetExtent가 마지막으로 설정한 크기와 다를 수 있습니다. 후자의 메서드는 메서드가 호출되는 시점에 개체의 표시 공간을 지시하지만 애플리케이션에 따라 결정된 대로 개체의 네이티브 크기를 반드시 변경하지는 않기 때문입니다.

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

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

발신자에 대한 참고 사항

컨테이너는 실행 중인 개체에 대해서만 이 호출을 수행할 수 있으므로 컨테이너는 캐시에서 로드된 개체의 표시 크기를 얻으려면 IViewObject2::GetExtent 를 대신 호출해야 합니다.

구현자에 대한 참고 사항

구현은 sizel 구조를 개체의 높이와 너비로 채우는 것으로 구성됩니다.

요구 사항

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