Поделиться через


Factory.CreateSmartTag - метод

Создает объект SmartTag, представляющий смарт-тег в документе.

Пространство имен:  Microsoft.Office.Tools.Word
Сборка:  Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)

Синтаксис

'Декларация
Function CreateSmartTag ( _
    smartTagType As String, _
    caption As String, _
    extension As ISmartTagExtension _
) As SmartTag
SmartTag CreateSmartTag(
    string smartTagType,
    string caption,
    ISmartTagExtension extension
)

Параметры

  • smartTagType
    Тип: System.String
    Уникальный идентификатор смарт-тега, состоящий из URI пространства имен и имени типа тега, разделенных символом "#".
  • caption
    Тип: System.String
    Имя смарт-тега, отображаемого в меню смарт-тегов.
  • extension
    Тип: Microsoft.Office.Tools.Word.ISmartTagExtension
    Необязательный.Объект расширения, определяющий пользовательский распознаватель для смарт-тега.

Возвращаемое значение

Тип: Microsoft.Office.Tools.Word.SmartTag
Новый смарт-тег.

Исключения

Исключение Условие
ArgumentException

Параметр smartTagType или caption равен значению nullпустая ссылка (Nothing в Visual Basic) или является пустым либо параметр smartTagType не является допустимым.

Заметки

Примером допустимой строки для параметра smartTagType является "http://smarttags.contoso.com#TagName". Строка типа смарт-тега с правильным форматом не содержит пробелов и начинается с буквы (a-z, A-Z), символа подчеркивания (_) или двоеточия (:).

Дополнительные сведения о смарт-тегах см. в разделах Общие сведения о смарт-тегах и Архитектура смарт-тегов.

Примеры

В следующем примере кода демонстрируется создание смарт-тега и действия в проекте документа Word. Чтобы воспользоваться этим примером, запустите его из класса ThisDocument.

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

simpleSmartTag.Terms.Add("blue")
simpleSmartTag.Actions = New Microsoft.Office.Tools.Word.Action() { _
    simpleAction}
Me.VstoSmartTags.Add(simpleSmartTag)
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);

Безопасность платформы .NET Framework

См. также

Ссылки

Factory Интерфейс

Microsoft.Office.Tools.Word - пространство имен