演练：使用应用程序级外接程序创建智能标记

项目
08/12/2011

此演练演示如何创建在每一个打开的文档中均可使用的应用程序级智能标记。此智能标记识别 Microsoft Office Word 文档中的汤匙度量值，并提供将相应的数量换算成盎司的操作。它在以汤匙表示的数量后添加等价的盎司量并用圆括号将盎司量括起来。

**适用于：**本主题中的信息适用于 Word 2007 的应用程序级项目。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

若要运行此智能标记，最终用户必须在 Word 中启用智能标记。有关更多信息，请参见如何：在 Word 和 Excel 中启用智能标记。

本演练阐释了以下任务：

创建使用正则表达式识别字符串的智能标记。
创建可从智能标记检索数据并修改所识别的智能标记文本的操作。

提示

以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。您安装的 Visual Studio 版本以及使用的设置决定了这些元素。有关更多信息，请参见使用设置。

系统必备

您需要以下组件来完成本演练：

Visual Studio 2010 的一个版本，其中包含 Microsoft Office 开发工具。有关更多信息，请参见[将计算机配置为开发 Office 解决方案](bb398242\(v=vs.100\).md)。

Word 2007。
.NET Framework 3.5。

提示

如果面向 .NET Framework 4，则必须编写不同的代码以创建智能标记和操作。有关更多信息，请参见智能标记的结构。

创建新项目

第一步是创建 Word 外接程序项目。

创建新项目

使用 Visual Basic 或 C# 创建一个名为“我的配方智能标记”的 Word 2007 外接程序项目。

有关更多信息，请参见如何：在 Visual Studio 中创建 Office 项目。

Visual Studio 会将“我的配方智能标记”项目添加到**“解决方案资源管理器”**中。

配置项目

该项目需要引用智能标记 DLL，还需要使用正则表达式。

配置项目

在**“项目”菜单上，单击“添加引用”**。
在**“.NET”选项卡上，选择“Microsoft.Office.Interop.SmartTag”，然后单击“确定”**。选择该程序集的 12.0.0.0 版。
在**“解决方案资源管理器”中，右击 ThisDocument.vb (Visual Basic) 或 ThisDocument.cs (C#)，然后单击“查看代码”**。

将以下代码行添加到文件顶部。

Imports System.Text.RegularExpressions

using System.Text.RegularExpressions;

创建智能标记

为了使智能标记能够找到并转换汤匙度量值，请向智能标记识别的术语列表中添加一个正则表达式，并创建一项在用户单击智能标记时可以使用的操作。

创建智能标记

使用下面的代码替换 ThisAddIn_Startup 类中的 ThisAddIn 事件处理程序。此代码创建一个表示智能标记的 SmartTag，并向智能标记识别的术语列表中添加一个正则表达式。

WithEvents RecipeAction As Microsoft.Office.Tools.Word.Action

Private Sub ThisAddIn_Startup(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Startup

    Dim SmartTagDemo As New Microsoft.Office.Tools.Word.SmartTag( _
        "www.microsoft.com/Demo#DemoSmartTag", "Recipe Smart Tag")

    SmartTagDemo.Expressions.Add(New Regex( _
        "(?'tbsNumber'[+-]?\b[0-9]+)?\s?(tbs|tablespoons|tablespoon)\b"))

private Microsoft.Office.Tools.Word.Action RecipeAction;

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Word.SmartTag SmartTagDemo =
        new Microsoft.Office.Tools.Word.SmartTag(
        @"www.microsoft.com/Demo#DemoSmartTag",
        @"Recipe Smart Tag");

    // Specify the terms to recognize.
    SmartTagDemo.Expressions.Add(new Regex(
        @"(?'tbsNumber'[+-]?\b[0-9]+)?\s?(tbs|tablespoons|tablespoon)\b"));

创建一个新的 Action，并将其添加到智能标记的 Actions 属性。 Action 表示用户可在智能标记菜单上，单击的项。

RecipeAction = New Microsoft.Office.Tools.Word.Action("Convert to ounces")
SmartTagDemo.Actions = New Microsoft.Office.Tools.Word.Action() {RecipeAction}

RecipeAction = new Microsoft.Office.Tools.Word.Action(
    @"Convert to ounces");

// Add the action to the smart tag.
SmartTagDemo.Actions = new Microsoft.Office.Tools.Word.Action[] { RecipeAction };

将此智能标记附加到 ThisAddIn 类的 VstoSmartTags 属性。在 C# 中，向操作的 Click 事件附加事件处理程序。

    Me.VstoSmartTags.Add(SmartTagDemo)
End Sub

    // Add the smart tag to the document.
    this.VstoSmartTags.Add(SmartTagDemo);

    RecipeAction.Click += new Microsoft.Office.Tools.Word.ActionClickEventHandler(
        RecipeAction_Click);
}

为操作创建事件处理程序

此事件处理程序从智能标记属性包内的键 tbsNumber 中检索汤匙值。然后，此事件处理程序将汤匙量换算成盎司，并将盎司值用括号括起来插入在汤匙值后面。

在本示例中，键 tbsNumber 标识通过为智能标记分配的正则表达式捕获的组。有关智能标记中的属性包和正则表达式的更多信息，请参见智能标记的结构。

创建事件处理程序

将下面的代码复制到 ThisAddIn 类中。

Private Sub RecipeAction_Click(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ActionEventArgs) _
    Handles RecipeAction.Click

    Dim value As String = e.Properties.Read("tbsNumber")
    Dim tbsRecipeAmount As Double = System.Convert.ToDouble(value)
    Dim ozRecipeAmount As Double = tbsRecipeAmount * 0.5
    e.Range.InsertAfter(" (" + ozRecipeAmount.ToString() + " oz)")
End Sub

private void RecipeAction_Click(object sender,
    Microsoft.Office.Tools.Word.ActionEventArgs e)
{
    string value = e.Properties.get_Read(@"tbsNumber");
    double tbsRecipeAmount = System.Convert.ToDouble(value);
    double ozRecipeAmount = tbsRecipeAmount * 0.5;
    e.Range.InsertAfter(" (" + ozRecipeAmount.ToString() + " oz)");
}

测试应用程序

现在可以测试文档，以验证此智能标记是否会将汤匙度量值换算成盎司。

测试工作簿

在 Word 中，启用智能标记。

有关更多信息，请参见如何：在 Word 和 Excel 中启用智能标记。
按 F5 运行项目。
在 Word 文档中，键入 1 tablespoon salt。
单击出现在 1 tablespoon 上方的智能标记图标，然后单击**“Convert to ounces”（换算成盎司）**。
确认是否在汤匙量后插入了等价的盎司量。

请参见

通过

演练：使用应用程序级外接程序创建智能标记

系统必备

创建新项目

创建新项目

配置项目

配置项目

创建智能标记

创建智能标记

为操作创建事件处理程序

创建事件处理程序

测试应用程序

测试工作簿

请参见

任务

概念

其他资源

其他资源