Compartir a través de

ApplicationFactory.CreateSmartTag (Método)

  • Artículo

Crea un objeto SmartTag que representa una etiqueta inteligente de una hoja de cálculo.Este tipo o miembro está diseñado para usarse exclusivamente en proyectos de 2007 Microsoft Office system. Las etiquetas inteligentes están desusadas en Office 2010.
.

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

Sintaxis

'Declaración
Function CreateSmartTag ( _
    smartTagType As String, _
    caption As String, _
    extension As ISmartTagExtension _
) As SmartTag

SmartTag CreateSmartTag(
    string smartTagType,
    string caption,
    ISmartTagExtension extension
)

Parámetros

  • smartTagType
    Tipo: System.String
    Identificador único de la etiqueta inteligente, compuesto por el identificador URI de un espacio de nombres y un nombre de tipo de etiqueta separados por una almohadilla (#).
  • caption
    Tipo: System.String
    Nombre de la etiqueta inteligente mostrado en el menú de etiquetas inteligentes.

Valor devuelto

Tipo: Microsoft.Office.Tools.Excel.SmartTag
Nueva etiqueta inteligente.

Excepciones

Excepción Condición
ArgumentException

smartTagType o caption es nullreferencia null (Nothing en Visual Basic) o está vacío, o bien smartTagType no es válido.

Comentarios

Un ejemplo de una cadena válida para el parámetro smartTagType es http://smarttags.contoso.com#NombreEtiqueta.Una cadena de tipo de etiqueta inteligente correctamente formada, no debe contener espacios en blanco, y debe comenzar con una letra (a-z, a-Z), un carácter de subrayado (_) o dos puntos (:).

Ejemplos

En el siguiente ejemplo de código se muestra cómo crear una etiqueta inteligente y una acción en un proyecto de complemento de Excel.Para usar este ejemplo, ejecute el código desde la clase ThisAddIn.

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

Seguridad de .NET Framework

Vea también

Referencia

ApplicationFactory Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)