ApplicationFactory.CreateSmartTag – metoda

Článek
01/03/2014

Vytvoří SmartTag objekt představující inteligentních značek v listu.Tento typ člena je určen pouze pro použití v projektech systému Microsoft Office 2007. V systému Office 2010 již nejsou inteligentní značky používány.
.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

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

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

Parametry

smartTagType
Typ: System.String
Jedinečný identifikátor pro inteligentní značky, tvořené identifikátor URI oboru názvů a názvu typu značky, odděleny znakem čísla (#).

caption
Typ: System.String
Název inteligentní značky se zobrazí v nabídce inteligentních značek.

extension
Typ: Microsoft.Office.Tools.Excel.ISmartTagExtension
Volitelné.Rozšíření objektu, který definuje vlastní rozpoznávání pro inteligentní značku.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.SmartTag
Nové inteligentní značky.

Výjimky

Výjimka	Podmínka
ArgumentException	smartTagTypenebo caption je nullodkaz null (Nothing v jazyce Visual Basic) nebo je prázdný, nebo smartTagType není platný.

Poznámky

Příklad platný řetězec smartTagType http://smarttags.contoso.com#TagName je parametr.Inteligentní značky ve správném typu řetězec neobsahuje mezery a začíná písmenem (a-z, A-Z), podtržítko (_) nebo dvojtečky (:).

Příklady

Následující příklad kódu ukazuje, jak vytvořit inteligentní značky a akce do aplikace Excel doplněk projektu.Chcete-li použít tento příklad spustit kód z ThisAddIn třídy.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

ApplicationFactory Rozhraní

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím