Partager via


ApplicationFactory.CreateSmartTag, méthode

Crée un objet SmartTag qui représente une balise active d'une feuille de calcul. Ce type ou ce membre vise à être utilisé uniquement dans les projets pour la version 2007 de Microsoft Office System. Les balises actives sont déconseillées dans Office 2010.
.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function CreateSmartTag ( _
    smartTagType As String, _
    caption As String, _
    extension As ISmartTagExtension _
) As SmartTag
SmartTag CreateSmartTag(
    string smartTagType,
    string caption,
    ISmartTagExtension extension
)

Paramètres

  • smartTagType
    Type : System.String
    Identificateur unique de la balise active, composé d'un URI d'espace de noms et d'un nom de type de balise séparés par un signe dièse (#).
  • caption
    Type : System.String
    Nom de la balise active, qui est affiché dans le menu Balise active.

Valeur de retour

Type : Microsoft.Office.Tools.Excel.SmartTag
Nouvelle balise active.

Exceptions

Exception Condition
ArgumentException

smartTagType ou caption est nullune référence null (Nothing en Visual Basic) ou vide, ou smartTagType n'est pas valide.

Notes

Un exemple de chaîne valide pour le paramètre smartTagType est http://smarttags.contoso.com#NomBalise. Une chaîne de type de balise active correcte ne contient pas d'espace blanc et commence par une lettre (a-z, A-Z), un trait de soulignement (_) ou le signe deux-points (:).

Exemples

L'exemple de code suivant montre comment créer une balise active et une action dans un projet de complément Excel. Pour utiliser cet exemple, exécutez le code à partir de la classe 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);
}

Sécurité .NET Framework

Voir aussi

Référence

ApplicationFactory Interface

Microsoft.Office.Tools.Excel, espace de noms