Share via

IOleDocumentView::SaveViewState メソッド (docobj.h)

  • [アーティクル]

ビューステートを指定したストリームに保存します。

構文

HRESULT SaveViewState(
  [in] LPSTREAM pstm
);

パラメーター

[in] pstm

ビューが状態データを保存するストリームへのポインター。

戻り値

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

リターン コード 説明
E_POINTER
 pstm の値は NULL です。
E_NOTIMPL
 このビューには、保存する意味のある状態はありません。 ほとんどのビューには少なくとも保存する価値のある状態情報があるため、このエラーはまれです。

注釈

ビューの状態には、ビューの種類、ズーム係数、挿入ポイントの位置などのプロパティが含まれます。 コンテナーは通常、ビューを非アクティブ化する前にこの関数を呼び出します。 その後、ストリームを使用して、 IOleDocumentView::ApplyViewState を使用して、同じドキュメントのビューをこの保存済み状態に再初期化できます。

IPersistStream を管理する規則に従って、ビューは CLSID をストリームの最初の要素として書き込む必要があります。 ドキュメントのストレージ表現に適用されるクロスプラットフォーム ファイル形式の互換性の問題も、このコンテキストに適用されます。

要件

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

こちらもご覧ください

IOleDocumentView

IOleDocumentView::ApplyViewState

IPersistStream