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
Assemblys : Microsoft.Office.Tools.Word.v4.0.Utilities (dans Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
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é. 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. . |
Début
Méthodes
Nom | Description | |
---|---|---|
Add | Ajoute une balise active à la fin de SmartTagCollection. 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. . |
|
AddRange | Ajoute un tableau de balises actives à la fin de SmartTagCollectionCe 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. . |
|
BeginInit | Infrastructure. | |
Contains | Détermine si SmartTagCollection contient une balise active spécifique. 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. . |
|
CopyTo | Copie les balises actives de SmartTagCollection vers un tableau unidimensionnel de balises actives, en commençant à un index spécifié. 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. . |
|
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. 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. . |
|
Insert | Insère une balise active dans SmartTagCollection à l'index spécifié. 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. . |
|
Remove | Supprime une balise active de SmartTagCollection. 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. . |
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.
[!REMARQUE]
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.
Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent .NET Framework 4 et .NET Framework 4.5. 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()
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);
}