ApplicationFactory.CreateSmartTag, méthode

Article
01/06/2014

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

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

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

Partager via