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.

• extension
  Type : Microsoft.Office.Tools.Excel.ISmartTagExtension
  Optionnel.Objet d'extension qui définit un module de reconnaissance personnalisé pour la balise active.

Valeur de retour

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

Exceptions

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

• Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ApplicationFactory Interface

Microsoft.Office.Tools.Excel, espace de noms