IViewObjectEx::GetRect 메서드(ocidl.h)

  • 아티클

요청된 그리기 측면을 설명하는 사각형을 검색합니다.

구문

HRESULT GetRect(
  [in]  DWORD   dwAspect,
  [out] LPRECTL pRect
);

매개 변수

[in] dwAspect

요청된 그리기 측면입니다.

[out] pRect

요청된 그리기 측면을 설명하는 사각형에 대한 포인터입니다.

반환 값

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

반환 코드 설명
DV_E_DVASPECT
 메서드는 지정된 측면을 지원하지 않습니다. 개체가 요청된 측면을 지원하지 않거나 측면이 사각형이 아닙니다.

설명

이 메서드는 지정된 그리기 측면을 설명하는 사각형을 반환합니다. 반환된 사각형은 개체의 원본을 기준으로 HIMETRIC 단위로 되어 있습니다. 반환되는 사각형은 다음과 같이 그리기 측면에 따라 달라집니다.

그리기 측면 Description
DVASPECT_CONTENT 개체는 전체 개체의 경계 사각형을 반환해야 합니다. 왼쪽 위 모서리는 개체의 원점이며 크기는 IViewObject2::GetExtent에서 반환한 범위와 같습니다.
DVASPECT_OPAQUE 사각형 불투명 영역이 있는 개체는 해당 사각형을 반환해야 합니다. 다른 사용자는 실패하고 오류 코드 DV_E_DVASPECT 반환해야 합니다.

사각형이 반환되면 해당 측면에 대해 IViewObject::D raw 를 호출하여 완전히 가려집니다. 컨테이너는 해당 직사각형을 사용하여 개체의 불투명 부분을 클리핑한 후 후면에서 프런트 패스로 개체를 그려야 합니다. 사각형이 아닌 불투명 영역이 있는 개체에서 이 메서드가 실패하는 경우 컨테이너는 DVASPECT_CONTENT 측면을 사용하여 전체 개체를 후면에서 앞부분으로 그려야 합니다.
DVASPECT_TRANSPARENT 개체는 투명하거나 불규칙한 모든 부분을 덮는 사각형을 반환해야 합니다. 개체에 투명하거나 불규칙한 부분이 없으면 DV_E_ASPECT 반환할 수 있습니다. 컨테이너는 이 사각형을 사용하여 지정된 개체의 투명한 부분과 겹치는 다른 개체가 있는지 여부를 확인할 수 있습니다.

요구 사항

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

추가 정보

IViewObjectEx