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

VC-SDK-OLE 专栏收录该内容
7 篇文章 0 订阅

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的PeekMessageGetMessage函数,或一个对话框。这样做可能引起系统的死机。OLE界面的方法和函数被在GetBorder中调用,有更近一步的约束。


快速信息


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


参见


Win32中的PeekMessageGetMessage

  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

相关推荐
©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值