IOleObject::GetExtent 메서드(oleidl.h)
실행 중인 개체의 현재 표시 크기를 검색합니다.
구문
HRESULT GetExtent(
[in] DWORD dwDrawAspect,
[out] SIZEL *psizel
);
매개 변수
[in] dwDrawAspect
제한을 검색할 개체의 측면입니다. 값은 열거형 DVASPECT 및 DVASPECT2 가져옵니다. 최적화된 그리기 인터페이스를 지원하는 최신 개체 및 컨테이너는 DVASPECT2 열거형 값을 지원합니다. 최적화된 그리기 인터페이스를 지원하지 않는 이전 개체 및 컨테이너는 DVASPECT2 지원하지 않을 수 있습니다. 이 메서드의 가장 일반적인 값은 컨테이너 내에서 개체의 전체 렌더링을 지정하는 DVASPECT_CONTENT.
[out] psizel
개체의 크기를 반환할 위치에 대한 포인터입니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다. 가능한 다른 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
제공된 dwDrawAspect 값이 잘못되었습니다. |
설명
컨테이너는 실행 중인 개체 에서 IOleObject::GetExtent 를 호출하여 현재 표시 크기를 검색합니다. 컨테이너가 해당 크기를 수용할 수 있는 경우 개체가 컨테이너보다 더 나은 크기를 알고 있기 때문에 일반적으로 이 작업을 수행합니다. 컨테이너는 일반적으로 개체 초기화의 일부로 이 호출을 수행합니다.
IOleObject::GetExtent에서 반환된 표시 크기는 IOleObject::SetExtent가 마지막으로 설정한 크기와 다를 수 있습니다. 후자의 메서드는 메서드가 호출되는 시점에 개체의 표시 공간을 지시하지만 애플리케이션에 따라 결정된 대로 개체의 네이티브 크기를 반드시 변경하지는 않기 때문입니다.
dwAspect에서 새 측면 중 하나가 요청된 경우 이 메서드는 실패하거나 DVASPECT_CONTENT 측면과 동일한 사각형을 반환할 수 있습니다.
발신자에 대한 참고 사항
컨테이너는 실행 중인 개체에 대해서만 이 호출을 수행할 수 있으므로 컨테이너는 캐시에서 로드된 개체의 표시 크기를 얻으려면 IViewObject2::GetExtent 를 대신 호출해야 합니다.구현자에 대한 참고 사항
구현은 sizel 구조를 개체의 높이와 너비로 채우는 것으로 구성됩니다.요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | oleidl.h |