IOleDocument::CreateView メソッド (docobj.h)

[アーティクル]
08/23/2023

呼び出し元のプロセスでドキュメントビューオブジェクトを作成し、そのオブジェクトの 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

このパラメーターは予約されており、0 である必要があります。

[out] ppView

新しいドキュメントビューオブジェクトへのインターフェイスポインターを受け取る IOleDocumentView ポインター変数へのポインター。成功した場合、呼び出し元は、ビューオブジェクトが不要になったときに ppview ポインターで IUnknown::Release を呼び出す役割を担います。

戻り値

このメソッドは、成功したS_OKを返します。その他の可能な戻り値は次のとおりです。

リターンコード	説明
E_FAIL	操作が失敗しました。
E_OUTOFMEMORY	操作に使用できるメモリが不足しています。
E_UNEXPECTED	予期しないエラーが発生しました。
E_POINTER	ppView のアドレスは NULL です。

注釈

ドキュメントオブジェクトコンテナーのドキュメントサイトは CreateView を 呼び出して、既定のデータから、または既存のストリームの内容を使用して、コンテナーのプロセスでそれ自体の新しいビューを作成するようにドキュメントオブジェクトに指示します。

CreateView を呼び出しても、新しいビュー自体は表示されません。そのためには、IOleDocumentView::Show または IOleDocumentView::UIActivate を呼び出す必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	docobj.h