SmartTagCollection - интерфейс

  • Статья

Представляет коллекцию смарт-тегов в решении Word или Excel, созданном с помощью средств разработки Office в Visual Studio.

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

Синтаксис

'Декларация
<GuidAttribute("30a90086-8c89-4e19-8299-47765d808408")> _
Public Interface SmartTagCollection _
    Inherits IEnumerable, IDisposable

[GuidAttribute("30a90086-8c89-4e19-8299-47765d808408")]
public interface SmartTagCollection : IEnumerable, 
    IDisposable

Тип SmartTagCollection предоставляет следующие члены.

Свойства

  Имя Описание
Открытое свойство Item Возвращает смарт-тег с указанным индексом.

В начало страницы

Методы

  Имя Описание
Открытый метод Add Добавляет смарт-тег в конец коллекции SmartTagCollection.
Открытый метод AddRange Добавляет массив смарт-тегов в конец коллекции SmartTagCollection.
Открытый метод BeginInit Инфраструктура.
Открытый метод Contains Определяет, содержит ли коллекция SmartTagCollection определенный смарт-тег.
Открытый метод CopyTo Копирует смарт-теги из коллекции SmartTagCollection в одномерный массив смарт-тегов, начиная с указанного индекса.
Открытый метод Dispose Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.)
Открытый метод EndInit Инфраструктура.
Открытый метод GetEnumerator Возвращает перечислитель, который выполняет итерацию по элементам коллекции. (Унаследовано от IEnumerable.)
Открытый метод IndexOf Определяет индекс указанного смарт-тега в коллекции SmartTagCollection.
Открытый метод Insert Вставляет смарт-тег в коллекцию SmartTagCollection по указанному индексу.
Открытый метод Remove Удаляет смарт-тег из коллекции SmartTagCollection.

В начало страницы

Заметки

При создании смарт-тега объект SmartTagBase добавляется в свойства Workbook.VstoSmartTags или Document.VstoSmartTags. Эти свойства имеют тип SmartTagCollection.

Дополнительные сведения о смарт-тегах в решениях Microsoft Office содержатся в разделе Общие сведения о смарт-тегах.

Примечание

Данный интерфейс реализован средствами Visual Studio Tools для среды выполнения Office. Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Использование

Этот тип предназначен для использования только в проектах Excel 2007 и Word 2007. Смарт-теги являются устаревшими в Excel 2010 и Word 2010. Дополнительные сведения см. в разделе Общие сведения о смарт-тегах.

В настоящей документации описывается версия данного типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены и примеры, предназначенные для данного типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Примеры

В следующем примере кода для добавления смарт-тега Microsoft.Office.Tools.Excel.SmartTag к коллекции смарт-тегов, доступ к которой предоставляется с помощью свойства Workbook.VstoSmartTags, используется метод Add. Данный пример кода является частью большего примера, приведенного в разделе Microsoft.Office.Tools.Excel.Action.

В этом примере демонстрируется настройка уровня документа.

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

Private Sub AddSmartTag()

    ' Create the smart tag for .NET Framework 4 projects.
    Dim smartTagDemo As Microsoft.Office.Tools.Excel.SmartTag = _
        Globals.Factory.CreateSmartTag(
        "www.microsoft.com/Demo#DemoSmartTag",
        "Demonstration Smart Tag")

    ' For .NET Framework 3.5 projects, use the following code to create the smart tag.
    ' Dim smartTagDemo As New  _
    '    Microsoft.Office.Tools.Excel.SmartTag( _
    '    "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}"))

    ' Create the action for .NET Framework 4 projects.
    displayAddress = Globals.Factory.CreateAction("To be replaced")

    ' For .NET Framework 3.5 projects, use the following code to create the action.
    ' displayAddress = New Microsoft.Office.Tools.Excel.Action("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()
{
    // Create the smart tag for .NET Framework 4 projects.
    Microsoft.Office.Tools.Excel.SmartTag smartTagDemo =
        Globals.Factory.CreateSmartTag(
            "www.microsoft.com/Demo#DemoSmartTag",
            "Demonstration Smart Tag");

    // For .NET Framework 3.5 projects, use the following code to create the smart tag.
    // Microsoft.Office.Tools.Excel.SmartTag smartTagDemo =
        // new Microsoft.Office.Tools.Excel.SmartTag(
        //     "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}"));

    // Create the action for .NET Framework 4 projects.
    displayAddress = Globals.Factory.CreateAction("To be replaced");

    // For .NET Framework 3.5 projects, use the following code to create the action.
    // displayAddress = new Microsoft.Office.Tools.Excel.Action("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);
}

См. также

Ссылки

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

Другие ресурсы

Общие сведения о смарт-тегах