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