Interface SmartTagCollection

Artigo
01/09/2014

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

Namespace: Microsoft.Office.Tools
Assemblies:   Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
  Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
  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
	Item	Obtém a marca inteligente no índice especificado. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010. .

Superior

Métodos

	Nome	Descrição
	Add	Adiciona uma marca inteligente ao final de SmartTagCollection. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010. .
	AddRange	Adiciona uma matriz de marcas inteligentes ao final de SmartTagCollection Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010. .
	BeginInit	Infraestrutura.
	Contains	Determina se SmartTagCollection contém uma marca inteligente específica. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010. .
	CopyTo	Copia marcas inteligentes em SmartTagCollection a uma matriz unidimensional de marcas inteligentes, começando em um índice especificado. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010. .
	Dispose	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de IDisposable.)
	EndInit	Infraestrutura.
	GetEnumerator	Retorna um enumerador que executa iterações através de uma coleção. (Herdado de IEnumerable.)
	IndexOf	Determina o índice de uma marca inteligente especificada em SmartTagCollection. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010. .
	Insert	Insere uma marca inteligente em SmartTagCollection no índice especificado. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010. .
	Remove	Remove uma marca inteligente de SmartTagCollection. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010. .

Superior

Comentários

Quando você cria uma marca inteligente, você adiciona um objeto de SmartTagBase para propriedades de Workbook.VstoSmartTags ou de Document.VstoSmartTags . Essas propriedades possuem o tipo SmartTagCollection.

Dica

Essa 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 Visão geral de tempo de execução do Visual Studio Tools for Office.

Uso

Este tipo destina-se a ser usado apenas em projetos para Excel 2007 e Word 2007. As marcas inteligentes serão preteridas no Excel 2010 e no Word 2010.

Essa documentação descreve a versão desse tipo que é usada apenas nos projetos do Office direcionados ao .NET Framework 4 e ao .NET Framework 4.5. Em projetos direcionados ao .NET Framework 3.5, esse tipo pode ter membros diferentes e os exemplos de código fornecidos para este tipo talvez não funcionem. Para conhecer a documentação sobre esse tipo de projeto direcionado 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 o método de Add para adicionar Microsoft.Office.Tools.Excel.SmartTag a coleção de marcas inteligentes exposto pela propriedade de Workbook.VstoSmartTags . Este exemplo de código é parte de um exemplo maior fornecido para Microsoft.Office.Tools.Excel.Action.

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

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

Consulte também

Referência

Namespace Microsoft.Office.Tools

Compartilhar via