SmartTagCollection-Schnittstelle

Stellt eine Auflistung von Smarttags in einer Word- oder Excel-Projektmappe dar, die mit den Office-Entwicklungstools in Visual Studio erstellt wurde.

Namespace:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

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

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

Der SmartTagCollection-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	Item	Ruft das Smarttag am angegebenen Index ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Add	Fügt ein Smarttag am Ende der SmartTagCollection hinzu.
	AddRange	Fügt ein Smarttagarray am Ende der SmartTagCollection hinzu.
	BeginInit	Infrastruktur.
	Contains	Stellt fest, ob die SmartTagCollection ein bestimmtes Smarttag enthält.
	CopyTo	Kopiert die Smarttags aus der SmartTagCollection in ein eindimensionales Smarttagarray und fängt dabei am angegebenen Index an.
	Dispose	Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
	EndInit	Infrastruktur.
	GetEnumerator	Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von IEnumerable geerbt.)
	IndexOf	Bestimmt den Index eines angegebenen Smarttags in der SmartTagCollection.
	Insert	Fügt ein Smarttag am angegebenen Index in die SmartTagCollection ein.
	Remove	Entfernt ein Smarttag aus der SmartTagCollection.

Zum Seitenanfang

Hinweise

Wenn Sie ein Smarttag erstellen, fügen Sie ein SmartTagBase-Objekt der Workbook.VstoSmartTags-Eigenschaft oder der Document.VstoSmartTags-Eigenschaft hinzu. Diese Eigenschaften verfügen über den Typ SmartTagCollection.

Weitere Informationen über das Verwenden von Smarttags in Office-Projektmappen finden Sie unter Übersicht über Smarttags.

Tipp

Diese Schnittstelle wird von der Visual Studio Tools for Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.

Verwendung

Dieser Typ ist gedacht dazu, nur in Projekten für Excel 2007 und Word 2007 verwendet zu werden. Smarttags sind in in Word 2010 und Excel 2010 veraltet. Weitere Informationen finden Sie unter Übersicht über Smarttags.

In dieser Dokumentation wird die Version dieses Typs beschrieben, der in Office-Projekten mit der Zielversion .NET Framework 4 verwendet wird. In Projekten mit der Zielversion .NET Framework 3.5 verfügt dieser Typ möglicherweise über unterschiedliche Member und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Dokumentation zu diesem Typ in Projekten mit der Zielversion .NET Framework 3.5 finden Sie im folgenden Verweisabschnitt in der Visual Studio 2008-Dokumentation: https://go.microsoft.com/fwlink/?LinkId=160658.

Beispiele

Im folgenden Code wird die Add-Methode verwendet, um der Smarttagauflistung, die von der Workbook.VstoSmartTags-Eigenschaft verfügbar gemacht wird, ein Microsoft.Office.Tools.Excel.SmartTag hinzuzufügen. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels zu Microsoft.Office.Tools.Excel.Action.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

Siehe auch

Referenz

Microsoft.Office.Tools-Namespace

Weitere Ressourcen

Übersicht über Smarttags