SmartTagCollection - интерфейс

Статья
05/19/2013

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

Пространство имен: Microsoft.Office.Tools
Сборки:   Microsoft.Office.Tools.Word.v4.0.Utilities (в Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
  Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
  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	Возвращает смарт-тег с указанным индексом. Этот тип или член предназначен для использования только в проектах выпуска 2007 системы Microsoft Office. Не рекомендуется использовать смарт-теги в Office 2010. .

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

Методы

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

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

Заметки

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

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

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

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

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

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформ .NET Framework 4 и .NET Framework 4.5. В проектах, предназначенных для платформы .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()

    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);
}

См. также

Ссылки

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

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