Factory.CreateSmartTag - метод

Статья
08/11/2011

Создает объект 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 - пространство имен

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