IOleDocumentView::SaveViewState メソッド (docobj.h)
ビューステートを指定したストリームに保存します。
構文
HRESULT SaveViewState(
[in] LPSTREAM pstm
);
パラメーター
[in] pstm
ビューが状態データを保存するストリームへのポインター。
戻り値
このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
pstm の値は NULL です。 |
|
このビューには、保存する意味のある状態はありません。 ほとんどのビューには少なくとも保存する価値のある状態情報があるため、このエラーはまれです。 |
注釈
ビューの状態には、ビューの種類、ズーム係数、挿入ポイントの位置などのプロパティが含まれます。 コンテナーは通常、ビューを非アクティブ化する前にこの関数を呼び出します。 その後、ストリームを使用して、 IOleDocumentView::ApplyViewState を使用して、同じドキュメントのビューをこの保存済み状態に再初期化できます。
IPersistStream を管理する規則に従って、ビューは CLSID をストリームの最初の要素として書き込む必要があります。 ドキュメントのストレージ表現に適用されるクロスプラットフォーム ファイル形式の互換性の問題も、このコンテキストに適用されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | docobj.h |