Compartilhar via

Interface SmartTagCollection

  • Artigo

Representa uma coleção de marcas inteligentes em uma solução do Word ou Excel criado usando as ferramentas de desenvolvimento do Office em Visual Studio.

Namespace:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)

Sintaxe

'Declaração
<GuidAttribute("30a90086-8c89-4e19-8299-47765d808408")> _
Public Interface SmartTagCollection _
    Inherits IEnumerable, IDisposable

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

O tipo SmartTagCollection expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública Item Obtém a marca inteligente no índice especificado.

Início

Métodos

  Nome Descrição
Método público Add Adiciona uma marca inteligente para o fim da SmartTagCollection.
Método público AddRange Adiciona uma matriz de marcas inteligentes para o fim da SmartTagCollection.
Método público BeginInit Infraestrutura.
Método público Contains Determina se a SmartTagCollection contém uma marca inteligente específica.
Método público CopyTo Copia as marcas inteligentes a SmartTagCollection para uma matriz unidimensional de marcas inteligentes, iniciando no índice especificado.
Método público Dispose Executa tarefas de definição de aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
Método público EndInit Infraestrutura.
Método público GetEnumerator Retorna um enumerador que itera por meio de uma coleção. (Herdado de IEnumerable.)
Método público IndexOf Determina o índice de uma marca inteligente especificada a SmartTagCollection.
Método público Insert Insere uma marca inteligente para o SmartTagCollection no índice especificado.
Método público Remove Remove uma marca inteligente a partir de SmartTagCollection.

Início

Comentários

Quando você cria uma marca inteligente, você adicionar um SmartTagBase o objeto para o Workbook.VstoSmartTags ou Document.VstoSmartTags Propriedades. Essas propriedades têm o tipo de SmartTagCollection.

Para obter mais informações sobre marcas inteligentes em soluções do Office, consulte Visão geral sobre marcas inteligentes.

ObservaçãoObservação

Esta interface é implementada pelo Visual Studio Tools for Office runtime. Ela não se destina a ser implementada em seu código. Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.

Usage

Esse tipo destina-se a ser usado apenas em projetos para o Excel 2007 e Word 2007. As marcas inteligentes são preteridas em 2010 do Excel e Word 2010. For more information, see Visão geral sobre marcas inteligentes.

Esta documentação descreve a versão deste tipo que é usada em projetos do Office destinados ao .NET Framework 4. Em projetos destinados ao .NET Framework 3.5, este tipo poderá ter membros diferentes, e os exemplos de código fornecidos para o tipo talvez não funcionem. Para obter documentação sobre este tipo em projetos destinados ao .NET Framework 3.5, consulte a seguinte seção de referência na documentação do Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Exemplos

O código a seguir usa a Add método para adicionar um Microsoft.Office.Tools.Excel.SmartTag à coleção de marcas inteligentes expostos pelo Workbook.VstoSmartTags propriedade. Este exemplo de código é parte de um exemplo maior fornecido para Microsoft.Office.Tools.Excel.Action.

Este exemplo é para uma personalização em nível de documento.

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

Consulte também

Referência

Namespace Microsoft.Office.Tools

Outros recursos

Visão geral sobre marcas inteligentes