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

아티클
02/29/2024

뷰를 활성화할 뷰포트의 사각형 좌표를 설정하거나 보기가 현재 활성화된 뷰포트의 좌표를 다시 설정합니다.

구문

HRESULT SetRect(
  [in] LPRECT prcView
);

매개 변수

[in] prcView

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

반환 값

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

반환 코드	설명
E_FAIL	작업이 실패했습니다.

설명

단일 SDI(문서 인터페이스) 애플리케이션의 경우 뷰포트는 프레임 창의 클라이언트 영역에서 도구 모음, 상태 막대 등에 할당된 공간을 뺀 값입니다. 여러 MDI(문서 인터페이스) 창의 경우 뷰포트는 MDI 문서 창의 클라이언트 영역에서 다른 프레임 수준 사용자 인터페이스 요소를 뺀 값입니다.

발신자에 대한 참고 사항

IOleDocumentView::SetRect 또는 IOleDocumentView::SetRectComplex 호출은 일반적으로 IOleDocumentView::UIActivate를 호출하고 IOleDocumentView::Show를 호출하기 전에 문서 개체에 대한 일반 활성화 시퀀스의 일부입니다.

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

구현자에 대한 참고 사항

뷰포트의 좌표는 IOleWindow::GetWindow를 통해 가져온 보기 창의 좌표 내에 있습니다. 보기는 prcView에 전달된 새 좌표에 맞게 크기가 조정되어야 합니다.

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

문서 뷰는 이 메서드를 완전히 구현해야 합니다. E_NOTIMPL 허용되는 반환 값이 아닙니다.

요구 사항

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

추가 정보

IOleDocumentView

다음을 통해 공유