Smarter Tag

上一篇Blog向大家介绍了智能标签。如前所说，开发智能标签程序并非很“舒适”，尤其是在部署上，因为我们必须将COM组件注册到计算机上，然后将其ClsID加到位于注册表的智能标签列表处。而如果使用SmarterTag（注意这个名词和SmartTag的区别），这个托管包装器来开发智能标签程序，那就爽多了。

首先，在 这里下载SmarterTag，除了SmarterTag之外，还有一个QuickStart可以下载，QuickStart是一个项目源码，演示了如何开发一个SmarterTag项目。

将下载的SmarterTag中的文件解压到磁盘上的某处，比如“C:\SmarterTag”，然后运行reg.bat文件，将SmarterTag注册到计算机上。然后我们要做的，就是打开VS.NET 2003，创建一个普通的类库项目，并且在项目中引用Microsoft.PRC.Office.SmarterTag.dll程序集。

下面演示的，是开发一个能够寻找到正文中的“kane”，然后显示一个标签，上面的菜单操作可以将正文中的“kane”修改为“kaneboy”的智能标签（这个示范也包含在QuickStart里面）。效果图如下：
 

一个SmarterTag必须实现ISmarterTag接口：

public class FindKaneboy : ISmarterTag

ISmarterTag接口要求我们的类实现如下的方法和属性：

public void Init(String applicationName)
{
    // 初始化代码
}

Init()可以让我们的SmarterTag在载入时，进行一些初始化工作。比如从后台载入客户名单等等。

public Boolean IsMatch(String text)
{
    return text.ToLower().Trim() == "kane";
}

IsMatch()用来判断参数中的文本是否符合智能标签要标记的文本。在这里，只要文本是“kane”就行了。

public String[] ActionTypeNames
{
    get
   {
    return new String[] {"SmarterTag.QuickStart.ReplaceKane, SmarterTag.QuickStart"};
   }
}

ActionTypeNames属性的作用是，决定在智能标签的菜单上，要出现哪些菜单项。每个菜单项都是一个实现了IAction接口的类。这里需要返回一个字符串数组，数组里面的每个元素，是一个菜单项对应的类的类型全名。这个返回的字符串数组的数量，也就决定了智能标签上会显示多少个操作菜单项。

接着我们就要构建一个实现了IAction接口的类了，IAction表示智能标签上的一个菜单项：

public class ReplaceKane : IAction

IAction只有一个属性和一个方法需要实现：

public String Caption
{
   get
   {
        return "补充为“kaneboy”";
   }
}

Caption属性返回要显示在菜单项上的文本。

public void InvokeAction(Object target, String applicationName, String text)
{
   Range rng = target as Range;

   Object start = rng.Start;
   Object end = rng.End;
   Range rng2 = rng.Document.Range(ref start, ref end);
   Object unit = WdUnits.wdCharacter;
   Object count = 3;
   rng2.MoveEnd(ref unit, ref count);

   if (rng2.Text != "kaneboy")
   {
        rng.Text = "kaneboy";
   }
}

OK，InvokeAction()方法稍微复杂一点，因为这个方法就是当用户点击智能标签上的这个菜单项时，要执行的代码。target参数表示在宿主程序（host application）中智能标签所标记的那块文本区域所对应的对象。宿主程序的不同，这个对象类型也不尽相同，对于Word而言，target是一个Range类型的对象。第二个参数applicationName标识了宿主程序的名称。第三个参数text是智能标签所标记的文本内容。

在上面InvokeAction()方法中，代码将智能标签所标记的文本内容从“kane”修改为了“kaneboy”。

由于我们编写的是完全的.Net程序，所以InvokeAction()是可以做任何.Net代码可以做的事情的（在权限允许的情况下）。比如显示一个MessageBox，或者显示一个WinForms窗口，或者调用WebService......这里就是业务逻辑代码的主要落脚点。

QuickStart中另外包含的SmarterTag识别了“kaneboy”，和上一篇Blog所说的那个标记博客堂最新文章作者的智能标签。