描述
由MSHTML调用，以使主机能够替换MSHTML菜单和工具栏。
C++ 语法
HRESULT ShowUI( DWORD dwID, IOleInPlaceActiveObject *pActiveObject, IOleCommandTarget *pCommandTarget, IOleInPlaceFrame *pFrame, IOleInPlaceUIWindow *pDoc ); |
PowerBASIC 语法
METHOD ShowUI ( _ BYVAL dwID AS DWORD, _ BYVAL pActiveObject AS IOleInPlaceActiveObject, _ BYVAL pCommandTarget AS IOleCommandTarget, _ BYVAL pFrame AS IOleInPlaceFrame, _ BYVAL pDoc AS IOleInPlaceUIWindow _ ) AS LONG |
参数
dwID |
[in]DWORD，它收到一个指示用户界面（UI）类型的DOCHOSTUITYPE值。 |
pActiveObject |
[in]指向活动对象的IOleInPlaceActiveObject界面的指针。 |
pCommandTarget |
[in]指向对象的IOleCommandTarget界面。 |
pFrame |
[in]指向对象的IOleInPlaceFrame界面。菜单和工具栏必须使用此参数。 |
pDoc |
[in]指向对象的IOleInPlaceUIWindow界面。工具栏必须使用此参数。 |
OBJRESULT
返回以下值之一：
S_OK |
主机显示自己的UI。MSHTML不会显示其UI。 |
S_FALSE |
主机没有显示自己的UI。MSHTML将显示其UI。 |
DOCHOST_E_UNKNOWN |
主机无法识别UI标识符。MSHTML将尝试替换标识符与以前的版本兼容，或显示自己的UI。 |
备注
如果主机使用任何交给它的接口作为此函数的一部分，主机应调用接口的AddRef方法来保存接口供以后使用。如果主机调用接口的AddRef方法，则当不再需要该接口时，主机还必须调用接口的Release方法。
主机可以通过使用IDM_DISABLEMODELESS和IDM_ENABLEMODELESS调用IOleCommandTarget.Exec来禁用MSHTML上的无模式UI。