Interfaccia SmartTagCollection

Articolo
01/06/2014

Rappresenta una raccolta di smart tag in una soluzione Word o Excel creata tramite gli Strumenti di sviluppo di Microsoft Office per Visual Studio.

Spazio dei nomi: Microsoft.Office.Tools
Assembly:   Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Sintassi

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

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

Il tipo SmartTagCollection espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Item	Ottiene lo smart tag in corrispondenza dell'indice specificato. Questo tipo o membro deve essere utilizzato solo nei progetti per Microsoft Office System 2007. Gli smart tag sono deprecati in Office 2010. .

In alto

Metodi

	Nome	Descrizione
	Add	Aggiunge uno smart tag alla fine dell'oggetto SmartTagCollection. Questo tipo o membro deve essere utilizzato solo nei progetti per Microsoft Office System 2007. Gli smart tag sono deprecati in Office 2010. .
	AddRange	Aggiunge una matrice di smart tag alla fine dell'oggetto SmartTagCollection Questo tipo o membro deve essere utilizzato solo nei progetti per Microsoft Office System 2007. Gli smart tag sono deprecati in Office 2010. .
	BeginInit	Infrastruttura.
	Contains	Consente di stabilire se l'oggetto SmartTagCollection contiene uno smart tag specifico. Questo tipo o membro deve essere utilizzato solo nei progetti per Microsoft Office System 2007. Gli smart tag sono deprecati in Office 2010. .
	CopyTo	Copia gli smart tag presenti nell'oggetto SmartTagCollection in una matrice unidimensionale di smart tag, a partire dall'indice specificato. Questo tipo o membro deve essere utilizzato solo nei progetti per Microsoft Office System 2007. Gli smart tag sono deprecati in Office 2010. .
	Dispose	Esegue attività definite dall'applicazione, ad esempio libera, rilascia o reimposta risorse non gestite. (Ereditato da IDisposable)
	EndInit	Infrastruttura.
	GetEnumerator	Restituisce un enumeratore che consente di scorrere una raccolta. (Ereditato da IEnumerable)
	IndexOf	Determina l'indice di uno smart tag specificato nell'oggetto SmartTagCollection. Questo tipo o membro deve essere utilizzato solo nei progetti per Microsoft Office System 2007. Gli smart tag sono deprecati in Office 2010. .
	Insert	Inserisce uno smart tag nell'oggetto SmartTagCollection in corrispondenza dell'indice specificato. Questo tipo o membro deve essere utilizzato solo nei progetti per Microsoft Office System 2007. Gli smart tag sono deprecati in Office 2010. .
	Remove	Rimuove uno smart tag dall'oggetto SmartTagCollection. Questo tipo o membro deve essere utilizzato solo nei progetti per Microsoft Office System 2007. Gli smart tag sono deprecati in Office 2010. .

In alto

Note

Quando si crea uno smart tag, aggiungere un oggetto SmartTagBase alle proprietà Workbook.VstoSmartTags o Document.VstoSmartTags. Il tipo di tali proprietà è SmartTagCollection.

Nota

Questa interfaccia è implementata dal runtime di Visual Studio Tools per Office. Non deve essere implementata nel codice. Per ulteriori informazioni, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

Utilizzo

Questo tipo deve essere utilizzato solo nei progetti per Excel 2007 e Word 2007. In Excel 2010 e Word 2010 gli smart tag sono stati deprecati.

Nella presente documentazione viene descritta la versione di questo tipo utilizzata nei progetti di Office destinati a .NET Framework 4 e .NET Framework 4.5. Nei progetti destinati a .NET Framework 3.5 questo tipo potrebbe avere membri diversi e gli esempi di codice forniti per il tipo potrebbero non funzionare. Per la documentazione relativa a questo tipo nei progetti destinati a .NET Framework 3.5, vedere la sezione di riferimento seguente nella documentazione di Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Esempi

Nell'esempio di codice riportato di seguito viene utilizzato il metodo Add per aggiungere un oggetto Microsoft.Office.Tools.Excel.SmartTag alla raccolta di smart tag esposta dalla proprietà Workbook.VstoSmartTags. Questo esempio di codice fa parte di un esempio più esaustivo fornito per Microsoft.Office.Tools.Excel.Action.

Questo esempio è valido per una personalizzazione a livello di documento.

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

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools

Share via