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

아티클
02/26/2024

별도의 팝업 창에 문서 보기를 표시합니다. 의미 체계는 OLEIVERB_OPEN IOleObject::D oVerb 과 동일합니다.

구문

HRESULT Open();

반환 값

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

반환 코드	설명
E_FAIL	작업이 실패했습니다.
E_OUTOFMEMORY	작업에 사용할 수 있는 메모리가 부족합니다.
E_UNEXPECTED	예기치 않은 오류가 발생했습니다.
E_NOTIMPL	이 뷰를 소유하는 문서 개체는 별도의 창 활성화를 지원하지 않습니다.

설명

브라우저 또는 "바인더"와 같은 컨테이너 애플리케이션에서 문서 개체를 보는 사용자는 한 번에 두 개 이상의 보기 또는 문서를 볼 수 있습니다. 브라우저는 한 번에 하나의 보기만 표시하므로 컨테이너는 필요에 따라 별도의 창에서 다른 보기 또는 문서를 표시하도록 요청하는 방법이 필요합니다. IOleDocumentView::Open 메서드는 이러한 방법을 제공합니다.

발신자에게 참고 사항

IOleDocumentView::Open을 성공적으로 호출한 다음 IOleDocumentView::Show를 호출하여 창을 숨기거나 창을 표시하고 포그라운드로 가져와야 합니다. 보기가 별도의 창에서 활성화되어 있는 동안 컨테이너는 필요한 만큼 창을 여러 번 표시하거나 숨길 수 있습니다.

구현자에 대한 참고 사항

문서 개체는 DOCMISC_CANTOPENEDIT 상태 플래그를 설정하고 이 메서드를 호출하는 컨테이너에 E_NOTIMPL 반환하여 별도의 창에서 활성화를 지원하지 않음을 나타냅니다.

구현은 주로 자체 IOleInPlaceObject::InPlaceDeactivate 메서드를 호출하는 뷰 개체로 구성되며, 문서 개체는 현재 위치 활성화 없이 실행 상태로 유지됩니다. 컨테이너가 IOleDocumentView::Show 를 호출할 때까지 문서 개체의 사용자 인터페이스가 표시되지 않습니다(위의 호출자에 대한 참고 사항 참조).

요구 사항

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