Export (0) Print
Expand All

ApplicationFactory.CreateSmartTag Method

Creates a SmartTag object that represents a smart tag on a document. This type or member is intended to be used only in projects for the 2007 Microsoft Office system. Smart tags are deprecated in Office 2010. .

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

SmartTag CreateSmartTag(
	string smartTagType,
	string caption,
	ISmartTagExtension extension
)

Parameters

smartTagType
Type: System.String

A unique identifier for the smart tag, composed of a namespace URI and a tag type name separated by a number sign (#).

caption
Type: System.String

The name of the smart tag, which is displayed on the smart tag menu.

extension
Type: Microsoft.Office.Tools.Word.ISmartTagExtension

Optional. An extension object that defines a custom recognizer for the smart tag.

Return Value

Type: Microsoft.Office.Tools.Word.SmartTag
The new smart tag.

ExceptionCondition
ArgumentException

smartTagType or caption is either null or empty, or smartTagType is not valid.

An example of a valid string for the smartTagType parameter is http://smarttags.contoso.com#TagName. A well-formed smart tag type string does not contain white space, and it starts with a letter (a-z, A-Z), an underscore (_) or a colon (:).

The following code example demonstrates how to create a smart tag and an action in a Word add-in project. To use this example, run the code from the ThisAddIn class.

Microsoft.Office.Tools.Word.SmartTag simpleSmartTag =
    Globals.Factory.CreateSmartTag(
    "www.microsoft.com/Demo#DemoSmartTag",
    "Test Smart Tag");
Microsoft.Office.Tools.Word.Action simpleAction =
    Globals.Factory.CreateAction("Test Action");

simpleSmartTag.Terms.Add("blue");
simpleSmartTag.Actions = new Microsoft.Office.Tools.Word.Action[] { 
    simpleAction };
this.VstoSmartTags.Add(simpleSmartTag);

Show:
© 2015 Microsoft