Auf Englisch lesen

Freigeben über


ApplicationFactory.CreateSmartTag-Methode

Erstellt ein SmartTag-Objekt, das ein Smarttag auf einem Arbeitsblatt darstellt.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.
.

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.

Rückgabewert

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

Ausnahmen

Ausnahme Bedingung
ArgumentException

smartTagType oder caption ist nullein Nullverweis (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 (:).

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()

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

.NET Framework-Sicherheit

Siehe auch

Referenz

ApplicationFactory Schnittstelle

Microsoft.Office.Tools.Excel-Namespace