ApplicationFactory.CreateSmartTag - метод

Статья
01/10/2014

Создает объект SmartTag, представляющий смарт-тег на листе. Этот тип или член предназначен для использования только в проектах выпуска 2007 системы Microsoft Office. Не рекомендуется использовать смарт-теги в Office 2010.
.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.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.Excel.ISmartTagExtension
Необязательный параметр.Объект расширения, определяющий пользовательский распознаватель для смарт-тега.

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

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

Исключения

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

Заметки

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

Примеры

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

WithEvents displayAddress As Microsoft.Office.Tools.Excel.Action

Private Sub AddSmartTag()

    Dim smartTagDemo As Microsoft.Office.Tools.Excel.SmartTag = _
        Globals.Factory.CreateSmartTag(
        "www.microsoft.com/Demo#DemoSmartTag",
        "Demonstration Smart Tag")

    ' Specify a term and an expression to recognize.
    smartTagDemo.Terms.Add("sale")
    smartTagDemo.Expressions.Add( _
        New System.Text.RegularExpressions.Regex( _
        "[I|i]ssue\s\d{5,6}"))

    displayAddress = Globals.Factory.CreateAction("To be replaced")

    ' Add the action to the smart tag.
    smartTagDemo.Actions = New Microsoft.Office.Tools.Excel.Action() { _
            displayAddress}

    ' Add the smart tag.
    Me.VstoSmartTags.Add(smartTagDemo)
End Sub

private Microsoft.Office.Tools.Excel.Action displayAddress;

private void AddSmartTag()
{
    Microsoft.Office.Tools.Excel.SmartTag smartTagDemo =
        Globals.Factory.CreateSmartTag(
            "www.microsoft.com/Demo#DemoSmartTag",
            "Demonstration Smart Tag");

    // Specify a term and an expression to recognize.
    smartTagDemo.Terms.Add("sale");
    smartTagDemo.Expressions.Add(
        new System.Text.RegularExpressions.Regex(
        @"[I|i]ssue\s\d{5,6}"));

    displayAddress = Globals.Factory.CreateAction("To be replaced");


    // Add the action to the smart tag.
    smartTagDemo.Actions = new Microsoft.Office.Tools.Excel.Action[] { 
        displayAddress };

    // Add the smart tag.
    this.VstoSmartTags.Add(smartTagDemo);

    displayAddress.BeforeCaptionShow += new 
        Microsoft.Office.Tools.Excel.BeforeCaptionShowEventHandler(
        DisplayAddress_BeforeCaptionShow);

    displayAddress.Click += new 
        Microsoft.Office.Tools.Excel.ActionClickEventHandler(
        DisplayAddress_Click);
}

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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

ApplicationFactory Интерфейс

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

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