使用NameCtrl为网页集成Office Communicator状态信息

NameCtrl是Office自带的一个ActiveX控件,它存在于C:\Program Files\Microsoft Office\Office12\NAME.DLL中。利用它可以显示Office Communicator的状态图标,并且图标包含了菜单,通过菜单可以进行聊天,发送邮件等操作。

关于NameCtrl的细节请访问http://msdn.microsoft.com/en-us/library/bb862236.aspx
Spirit在《Web系统集成OCS在线状态功能》一文中向大家介绍了如何使用这个控件,而我这篇文章将从NameCtrl的一个方法和一个事件入手,来更完美的在网页中集成Office Communicator状态信息。
先来谈谈直接使用NameCtrl来显示状态的好处吧:
NameCtrl是Office提供的ActiveX控件,我们只需要直接在HTML中编写非常简单的JavaScript代码来和它交互,而不必编写Server端代码,轻而易举的实现Ajax效果。
但是它也有一些缺憾:
首先,NameCtrl是不可以永久显示的,它需要你调用它的ShowOOUI来显示状态图标,当你点击此状态图标打开菜单,然后关闭菜单后,这个图标也就不见了;
其次,NameCtrl的菜单是不可以自定义的,有时候我们并不想显示这个菜单。

如果你想要像Office Communicator内置的联系人状态显示效果,方法不止一种,本文还是使用NameCtrl控件,利用它的一个方法(GetStatus)和一个事件(OnStatusChange)来完成这样的效果。
oc_contacts

下面来介绍一下GetStatus方法和OnStatusChange事件:
GetStatus(bstrName, bstrID)
此方法用来订阅联系人的状态信息。它的参数bstrName表示联系人的账号;而参数bstrID则是一个HTML元素的ID,这个ID有什么用呢?请往下看。
MyOnStatusChange(name, status, id)
当通过GetStatus订阅的联系人状态发生了改变,就会触发此事件。它的参数name表示联系人的账号;参数status表示联系人的当前状态,是一个int值,下面我会列出可能的值和其含义;参数id就是我们调用GetStatus是传入的参数bstrID了。
在我的测试中发现,status的值和Office Communicator的默认状态有如下对应关系:
0:空闲
1:显示为脱机;脱机
2:离开
3:忙碌
4:马上回来
9:请勿打扰
中间空了几个是什么我也不知道。
那么在我们的网页中如何使用这两个方法呢?
首先,我们在初始化联系人列表时,在所有联系人前面默认添加一个状态图标(这个图标可以显示为脱机状态),然后,调用GetStatus方法来订阅所有联系人的状态信息。

NameObj.GetStatus(childNode.Attributes["Email"], childNode.ImageElement().id);

然后,处理OnStatusChange事件,根据传入参数来改变UI的中相应的状态图标。

function MyOnStatusChange(name, status, id)
{
  var img = document.getElementById(id);
img.src = "images/" + status + ".png";
}

最后,别忘了初始化NameCtrl控件并为其绑定OnStatusChange事件。

function InitializeObject()
{
  try
{
  NameObj = new ActiveXObject("Name.NameCtrl");
  NameObj.OnStatusChange = MyOnStatusChange;
}
  catch(e){}
}
InitializeObject();

OK,看一下最终的效果吧:

oc_status

不过NameCtrl有个缺陷,如果你为Office Communicator定制了自定义状态,那么这些自定义状态被NameCtrl捕获后,永远是空闲(0)状态。

发表评论

电子邮件地址不会被公开。 必填项已用*标注