SmartTagCollection, interface

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
	Item	Obtient la balise active à l'index spécifié.

Début

Méthodes

	Nom	Description
	Add	Ajoute une balise active à la fin de SmartTagCollection.
	AddRange	Ajoute un tableau de balises actives à la fin de SmartTagCollection.
	BeginInit	Infrastructure.
	Contains	Détermine si SmartTagCollection contient une balise active spécifique.
	CopyTo	Copie les balises actives de SmartTagCollection vers un tableau unidimensionnel de balises actives, en commençant à un index spécifié.
	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.)
	EndInit	Infrastructure.
	GetEnumerator	Retourne un énumérateur qui itère au sein d'une collection. (Hérité de IEnumerable.)
	IndexOf	Détermine l'index d'une balise active spécifique dans SmartTagCollection.
	Insert	Insère une balise active dans SmartTagCollection à l'index spécifié.
	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.

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