IOleDocument::CreateView 方法 (docobj.h)

在呼叫端的程式中建立文件檢視物件,並取得該物件的 IOleDocumentView 介面指標。

語法

HRESULT CreateView(
  [in]  IOleInPlaceSite  *pIPSite,
  [in]  IStream          *pstm,
  [in]  DWORD            dwReserved,
  [out] IOleDocumentView **ppView
);

參數

[in] pIPSite

IOleInPlaceSite 介面的指標,表示要與新文件檢視對象相關聯的檢視網站物件。 例如,當檢視包含在新的未初始化檔物件中時,這個參數可以是 NULL,在此情況下,呼叫端必須使用 後續呼叫 IOleDocumentView::SetInPlaceSite 來初始化檢視。

[in] pstm

數據流的指標,其中包含新文件檢視對象應該初始化本身的數據。 如果 為 NULL,則檔案物件會以預設狀態初始化新的文件檢視物件。

[in] dwReserved

此參數是保留的,而且必須是零。

[out] ppView

IOleDocumentView 指標變數的指標,可接收新文件檢視對象的介面指標。 成功時,呼叫端會負責在不再需要檢視物件時,在 ppview 指標上呼叫 IUnknown::Release

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_FAIL
作業失敗。
E_OUTOFMEMORY
作業的記憶體不足。
E_UNEXPECTED
已發生未預期的錯誤。
E_POINTER
ppView 中的位址為 NULL

備註

文件物件容器的文件網站會呼叫 CreateView ,指示檔對象從預設數據或使用現有數據流的內容,在容器的程式中建立本身的新檢視。

呼叫 CreateView 並不會讓新檢視自行顯示。 若要這樣做,需要呼叫 IOleDocumentView::ShowIOleDocumentView::UIActivate

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 docobj.h

另請參閱

IOleDocument

IOleDocumentSite::ActivateMe

IOleDocumentView::ApplyViewState

IOleDocumentView::SetInPlaceSite

IOleDocumentView::Show

IOleDocumentView::UIActivate