Partager via

SmartTagCollection, interface

  • Article

Représente une collection de balises actives d'une solution Word ou Excel créée à l'aide des outils de développement Office dans Visual Studio.

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

Syntaxe

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

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

Le type SmartTagCollection expose les membres suivants.

Propriétés

  Nom Description
Propriété publique Item Obtient la balise active à l'index spécifié.

Début

Méthodes

  Nom Description
Méthode publique Add Ajoute une balise active à la fin de SmartTagCollection.
Méthode publique AddRange Ajoute un tableau de balises actives à la fin de SmartTagCollection.
Méthode publique BeginInit Infrastructure.
Méthode publique Contains Détermine si SmartTagCollection contient une balise active spécifique.
Méthode publique CopyTo Copie les balises actives de SmartTagCollection vers un tableau unidimensionnel de balises actives, en commençant à un index spécifié.
Méthode publique Dispose Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de IDisposable.)
Méthode publique EndInit Infrastructure.
Méthode publique GetEnumerator Retourne un énumérateur qui itère au sein d'une collection. (Hérité de IEnumerable.)
Méthode publique IndexOf Détermine l'index d'une balise active spécifique dans SmartTagCollection.
Méthode publique Insert Insère une balise active dans SmartTagCollection à l'index spécifié.
Méthode publique Remove Supprime une balise active de SmartTagCollection.

Début

Notes

Lorsque vous créez une balise active, vous ajoutez un objet SmartTagBase aux propriétés Workbook.VstoSmartTags ou Document.VstoSmartTags. Ces propriétés ont le type SmartTagCollection.

Pour plus d'informations sur les balises actives des solutions Office, consultez Vue d'ensemble des balises actives.

Notes

Cette interface est implémentée par Visual Studio Tools pour Office Runtime. Elle n'est pas destinée à être implémentée dans votre code. Pour plus d'informations, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime.

Utilisation

Ce type vise à être utilisé uniquement dans les projets pour Excel 2007 et Word 2007. Les balises actives sont déconseillées dans Excel 2010 et Word 2010. Pour plus d'informations, consultez Vue d'ensemble des balises actives.

Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent .NET Framework 4. Dans les projets qui ciblent .NET Framework 3.5, ce type peut contenir d'autres membres, et les exemples de code qui y figurent sont susceptibles de ne pas fonctionner. Pour obtenir de la documentation sur ce type dans les projets ciblant .NET Framework 3.5, consultez la section de référence suivante dans la documentation Visual Studio 2008 : https://go.microsoft.com/fwlink/?LinkId=160658.

Exemples

Le code suivant utilise la méthode Add pour ajouter un Microsoft.Office.Tools.Excel.SmartTag à la collection des balises actives exposées par la propriété Workbook.VstoSmartTags. Cet exemple de code fait partie d'un exemple plus complet, fourni pour Microsoft.Office.Tools.Excel.Action.

Cet exemple illustre une personnalisation au niveau du document.

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

Voir aussi

Référence

Microsoft.Office.Tools, espace de noms

Autres ressources

Vue d'ensemble des balises actives