IOleDocumentView：：Show 方法 (docobj.h)

项目
02/29/2024

激活或停用视图。

语法

HRESULT Show(
  [in] BOOL fShow
);

参数

[in] fShow

如果 为 TRUE，则视图将显示自身。如果 为 FALSE，则视图将隐藏自身。

返回值

此方法在成功时返回S_OK。其他可能的返回值包括以下内容。

返回代码	说明
E_FAIL	此操作失败。
E_OUTOFMEMORY	可用于操作的内存不足。
E_UNEXPECTED	发生了意外错误。

注解

调用 Show 是激活序列中的最后一步，因为在显示文档对象之前，文档对象必须确切地知道它占用的空间，并具有其所有可用工具。

调用方备注

为激活视图而调用此方法时，应先调用 IOleDocumentView：：SetInPlaceSite、 IOleDocumentView：：UIActivate 和 IOleDocumentView：：SetRect (或 IOleDocumentView：：SetRectComplex) 。

实施者说明

此方法的实现应体现以下伪代码。

if (fShow)
    {
    In-place activate the view but do not UI activate it.
    Show the view window. 
    }
else
    {
    Call IOleDocumentView::UIActivate(FALSE) on this view
    Hide the view window
    }

文档对象的所有视图必须至少支持就地激活;E_NOTIMPL 不是可接受的值。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	docobj.h