Compartir a través de

SmartTagCollection (Interfaz)

  • Artículo

Representa una colección de etiquetas inteligentes en una solución de Word o Excel creada mediante las herramientas de desarrollo de Office incluidas en Visual Studio.

Espacio de nombres:  Microsoft.Office.Tools
Ensamblado:  Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)

Sintaxis

'Declaración
<GuidAttribute("30a90086-8c89-4e19-8299-47765d808408")> _
Public Interface SmartTagCollection _
    Inherits IEnumerable, IDisposable

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

El tipo SmartTagCollection expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública Item Obtiene la etiqueta inteligente en el índice especificado.

Arriba

Métodos

  Nombre Descripción
Método público Add Agrega una etiqueta inteligente al final de la SmartTagCollection.
Método público AddRange Agrega una matriz de etiquetas inteligentes al final de la SmartTagCollection.
Método público BeginInit Infraestructura.
Método público Contains Determina si la SmartTagCollection contiene una etiqueta inteligente específica.
Método público CopyTo Copia las etiquetas inteligentes de SmartTagCollection en una matriz unidimensional de etiquetas inteligentes, comenzando en un índice especificado.
Método público Dispose Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Se hereda de IDisposable).
Método público EndInit Infraestructura.
Método público GetEnumerator Devuelve un enumerador que recorre en iteración una colección. (Se hereda de IEnumerable).
Método público IndexOf Determina el índice de una etiqueta inteligente especificada de SmartTagCollection.
Método público Insert Inserta una etiqueta inteligente en SmartTagCollection en el índice especificado.
Método público Remove Quita una etiqueta inteligente de SmartTagCollection.

Arriba

Comentarios

Al crear una etiqueta inteligente, se agrega un objeto SmartTagBase a las propiedades Document.VstoSmartTags o Workbook.VstoSmartTags. Estas propiedades tienen el tipo SmartTagCollection.

Para obtener más información sobre las etiquetas inteligentes en soluciones de Office, vea Información general sobre etiquetas inteligentes.

Nota

Esta interfaz está implementada por el motor en tiempo de ejecución de Visual Studio Tools para Office. No está prevista su implementación en el código. Para obtener más información, vea Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

Uso

Este tipo está pensado para su uso solo en proyectos para Excel 2007 y Word 2007. Las etiquetas inteligentes están desusadas en Excel 2010 y en Word 2010 Para obtener más información, vea Información general sobre etiquetas inteligentes.

Esta documentación describe la versión de este tipo que se utiliza en los proyectos de Office destinados a .NET Framework 4. En los proyectos destinados a .NET Framework 3.5, este tipo puede tener miembros diferentes y es posible que los ejemplos de código proporcionados para dicho tipo no funcionen. Para informarse sobre este tipo en los proyectos destinados a .NET Framework 3.5, vea la siguiente sección de referencia en la documentación de Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Ejemplos

El código siguiente utiliza el método Add para agregar Microsoft.Office.Tools.Excel.SmartTag a la colección de etiquetas inteligentes expuestas por la propiedad Workbook.VstoSmartTags. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para Microsoft.Office.Tools.Excel.Action.

Se trata de un ejemplo para una personalización en el nivel del 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);
}

Vea también

Referencia

Microsoft.Office.Tools (Espacio de nombres)

Otros recursos

Información general sobre etiquetas inteligentes