IOleDocumentView::SetRectComplex 메서드(docobj.h)

아티클
02/28/2024

뷰포트, 스크롤 막대 및 크기 상자의 사각형 좌표를 설정합니다.

구문

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

매개 변수

[in] prcView

뷰포트의 좌표를 포함하는 RECT 구조체에 대한 포인터입니다.

[in] prcHScroll

가로 스크롤 막대의 좌표를 포함하는 RECT 구조체에 대한 포인터입니다.

[in] prcVScroll

세로 스크롤 막대의 좌표를 포함하는 RECT 구조체에 대한 포인터입니다.

[in] prcSizeBox

크기 상자의 좌표를 포함하는 RECT 구조체에 대한 포인터입니다.

반환 값

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

반환 코드	설명
E_FAIL	작업이 실패했습니다.
E_NOTIMPL	이 뷰를 소유하는 문서 개체는 복잡한 사각형을 지원하지 않습니다.

설명

단일 문서가 여러 시트 또는 페이지로 구성된 통합 문서 은유를 지원하는 보기 프레임은 일반적으로 이 메서드를 호출하여 모든 시트 또는 페이지에서 공통적으로 사용할 좌표를 설정합니다.

발신자에 대한 참고 사항

IOleDocumentView::SetRectComplex 호출은 일반적으로 IOleDocumentView::UIActivate를 호출하고 IOleDocumentView::Show를 호출하기 전에 복잡한 사각형을 지원하는 문서 개체에 대한 일반 활성화 시퀀스의 일부입니다.

문서 개체를 표시하는 데 사용되는 창의 크기가 조정될 때마다 컨테이너는 IOleDocumentView::SetRectComplex 또는 IOleDocumentView::SetRect 를 호출하여 뷰 개체의 크기를 새 창 차원으로 조정하도록 지시해야 합니다.

구현자에 대한 참고 사항

복잡한 사각형을 지원하는 문서 개체는 DOCMISC 및 IOleDocument::GetDocMiscStatus에 설명된 대로 DOCMISC_SUPPORTCOMPLEXRECTANGLES로 표시됩니다. 이 메서드를 지원하지 않는 문서 개체는 E_NOTIMPL 반환할 수 있습니다.

이 메서드에 대한 호출을 받으면 보기는 prcView에 지정된 좌표에 맞게 크기를 조정하고 해당 스크롤 막대 및 크기 상자를 prcHScroll, prcVScroll 및 prcSizeBox에 설명된 영역에 맞게 조정해야 합니다.

이 메서드는 [input_sync] 특성으로 정의됩니다. 즉, 구현 개체가 이 메서드를 실행하는 동안 다른 input_sync 아닌 RPC 호출을 생성하거나 만들 수 없습니다.

요구 사항

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

추가 정보

IOleDocument::GetDocMiscStatus

IOleDocumentView

다음을 통해 공유