Freigeben über


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
Assemblys:   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)

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
Öffentliche Eigenschaft Item Ruft das Smarttag am angegebenen Index ab. Dieser Typ oder Member ist nur für die Verwendung in Projekten für das Microsoft Office 2007-System vorgesehen. Smarttags sind in Office 2010 veraltet.
.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode Add Fügt ein Smarttag am Ende der SmartTagCollection hinzu. Dieser Typ oder Member ist nur für die Verwendung in Projekten für das Microsoft Office 2007-System vorgesehen. Smarttags sind in Office 2010 veraltet.
.
Öffentliche Methode AddRange Fügt ein Smarttagarray am Ende der SmartTagCollectionDieser Typ oder Member ist nur für die Verwendung in Projekten für das Microsoft Office 2007-System vorgesehen. Smarttags sind in Office 2010 veraltet.
hinzu.
Öffentliche Methode BeginInit Infrastruktur.
Öffentliche Methode Contains Stellt fest, ob die SmartTagCollection ein bestimmtes Smarttag enthält. Dieser Typ oder Member ist nur für die Verwendung in Projekten für das Microsoft Office 2007-System vorgesehen. Smarttags sind in Office 2010 veraltet.
.
Öffentliche Methode CopyTo Kopiert die Smarttags aus der SmartTagCollection in ein eindimensionales Smarttagarray und fängt dabei am angegebenen Index an. Dieser Typ oder Member ist nur für die Verwendung in Projekten für das Microsoft Office 2007-System vorgesehen. Smarttags sind in Office 2010 veraltet.
.
Öffentliche Methode Dispose Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
Öffentliche Methode EndInit Infrastruktur.
Öffentliche Methode GetEnumerator Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von IEnumerable geerbt.)
Öffentliche Methode IndexOf Bestimmt den Index eines angegebenen Smarttags in der SmartTagCollection. Dieser Typ oder Member ist nur für die Verwendung in Projekten für das Microsoft Office 2007-System vorgesehen. Smarttags sind in Office 2010 veraltet.
.
Öffentliche Methode Insert Fügt ein Smarttag am angegebenen Index in die SmartTagCollection ein. Dieser Typ oder Member ist nur für die Verwendung in Projekten für das Microsoft Office 2007-System vorgesehen. Smarttags sind in Office 2010 veraltet.
.
Öffentliche Methode Remove Entfernt ein Smarttag aus der SmartTagCollection. Dieser Typ oder Member ist nur für die Verwendung in Projekten für das Microsoft Office 2007-System vorgesehen. Smarttags sind in Office 2010 veraltet.
.

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.

HinweisHinweis

Diese Schnittstelle wird von der Visual Studio-Tools für 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.

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und .NET Framework 4.5 ausgerichtet sind. In Projekten, die auf .NET Framework 3.5 abzielen, 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()

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

Siehe auch

Referenz

Microsoft.Office.Tools-Namespace