ApplicationFactory.CreateSmartTag-Methode

Artikel
08/10/2011

Erstellt ein SmartTag-Objekt, das ein Smarttag auf einem Arbeitsblatt darstellt.

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

Syntax

'Declaration
Function CreateSmartTag ( _
    smartTagType As String, _
    caption As String, _
    extension As ISmartTagExtension _
) As SmartTag

SmartTag CreateSmartTag(
    string smartTagType,
    string caption,
    ISmartTagExtension extension
)

Parameter

smartTagType
Typ: System.String
Eindeutiger Bezeichner für das Smarttag, der aus einem Namespace-URI und einem Tagtypnamen besteht, die durch ein Nummernzeichen (#) getrennt sind.

caption
Typ: System.String
Der Name des Smarttags, der im Smarttagmenü angezeigt wird.

extension
Typ: Microsoft.Office.Tools.Excel.ISmartTagExtension
Optional.Ein Erweiterungsobjekt, das eine benutzerdefinierte Erkennung für das Smarttag definiert.

Rückgabewert

Typ: Microsoft.Office.Tools.Excel.SmartTag
Das neue Smarttag.

Ausnahmen

Ausnahme	Bedingung
ArgumentException	smartTagType oder caption ist nullNULL-Verweis (Nothing in Visual Basic) oder leer, oder smartTagType ist nicht gültig.

Hinweise

Ein Beispiel für eine gültige Zeichenfolge für den smartTagType-Parameter ist http://smarttags.contoso.com#TagName. Eine wohlgeformte Smarttag-Typzeichenfolge enthält keine Leerzeichen und beginnt mit einem Buchstaben (a-z, A-Z), einem Unterstrich (_) oder einem Doppelpunkt (:).

Weitere Informationen zu Smarttags finden Sie unter Übersicht über Smarttags und Smarttagarchitektur.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Smarttag und eine Aktion in einem Excel-Add-In-Projekt erstellt werden. Um dieses Codebeispiel verwenden zu können, müssen Sie den Code in der ThisAddIn-Klasse ausführen.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ApplicationFactory Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über