IOleDocumentView::Clone 메서드(docobj.h)
현재 뷰의 내부 상태와 동일한 중복 보기 개체를 만듭니다.
구문
HRESULT Clone(
[in] IOleInPlaceSite *pIPSiteNew,
[out] IOleDocumentView **ppViewNew
);
매개 변수
[in] pIPSiteNew
새 뷰 개체가 활성화될 보기 사이트를 나타내는 IOleInPlaceSite 인터페이스에 대한 포인터입니다. 이 포인터를 받으면 복제 중인 뷰가 새 보기의 IOleDocumentView::SetInPlaceSite 메서드에 전달되어야 합니다. 이 포인터는 NULL일 수 있습니다. 이 경우 호출자는 새 보기에서 직접 IOleDocumentView::SetInPlaceSite 를 호출해야 합니다.
[out] ppViewNew
새 뷰 개체에 대한 인터페이스 포인터를 수신하는 IOleDocumentView 포인터 변수에 대한 포인터입니다. 호출자는 더 이상 필요하지 않은 경우 ppViewNew 를 해제할 책임이 있습니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.
반환 코드 | 설명 |
---|---|
|
작업이 실패했습니다. |
|
ppViewNew의 값은 NULL입니다. |
|
뷰 개체는 이 인터페이스를 구현하지 않습니다. |
설명
이 메서드는 다른 뷰포트 및 보기 사이트를 사용하지만 복제 중인 뷰와 동일한 보기 컨텍스트를 사용하여 새 보기를 만드는 데 유용합니다. 일반적으로 MDI 애플리케이션을 호스팅하는 컨테이너는 이 메서드를 호출하여 "창/새 창" 기능을 제공합니다.
요구 사항
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | docobj.h |