OLE SDK——框架界面(二)：IOleInPlaceFrame::SetStatusText

IOleInPlaceFrame::SetStatusText

在容器的框架窗口状态行设置和显示关于在位(in-place)对象的状态文本。

HRESULT SetStatusText( LPCOLESTR pszStatusText //指向显示消息的指针);

参数

pszStatusText 包含要显示消息的以空字符结束的字符串的地址。

返回值

这个方法支持标准返回值E_FAIL，E_INVALIDARG和E_UNEXPECTED，也支持下列的：

S_OK 文本被显示了。 S_TRUNCATED 一些文本被显示，但消息太长有一些被删去了。

注释

调用者注意

如果容器框架窗口有状态行，当你需要告诉容器在它的框架状态行显示对象文本时，你应该调用SetStatusText。因为窗口的框架窗口自己拥有状态行，调用IOleInPlaceFrame::SetStatusText只是让一个对象可以在窗口的框架窗口中显示状态信息的方法。如果容器拒绝了对象的请求，对应应用仍然可以协商取得边框空间来显示它自己的状态栏。

注意 当在容器所拥有的菜单和在位(in-place)对象所拥有的菜单之间切换时，如果对象没有调用容器的IOleInPlaceFrame::SetStatusText方法，状态栏文本不会被适当的反映。例如，如果在一个在位(in-place)会话期间，用户选择了File菜单，状态栏将反映用户选择的这个菜单将发生的动作。如果用户选择了Edit菜单(被在位对象所拥有的)，状态栏将不会改变，除非IOleInPlaceFrame::SetStatusText发生了调用。这是因为容器没有办法分辨一个对象的菜单已经被激活，因为所有容器想捕获的消息现在都发给对象了。

实现注意

要避免潜在的问题，所有对象被在位激活都应该处理WM_MENUSELECT消息和调用IOleInPlaceFrame::SetStatusText，即使对象不提供状态信息(这样的话，对象可以刚好为请求状态文本提供一个NULL字符串。)

注意  当执行IOleInPlaceFrame::SetStatusText的时候，不可以调用Windows的PeekMessage和GetMessage函数，或一个对话框。这样做可能引起系统的死机。OLE界面的方法和函数被在GetBorder中调用，有更近一步的约束。

快速信息

  Windows NT: 3.1或更高版本。  Windows: Windows 95或更高版本。  Windows CE: 不支持。  Header: oleidl.h。

参见

Win32中的PeekMessage，GetMessage