Aracılığıyla paylaş

Factory.CreateSmartTag Yöntem

  • Makale

Oluşturur bir SmartTag nesnesini temsil eden bir akıllı etiket üzerinde bir çalışma.

Ad alanı:  Microsoft.Office.Tools.Excel
Derleme:  Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll içinde)

Sözdizimi

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

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

Parametreler

  • smartTagType
    Tür: System.String
    Adı bir sayı işareti (#) ile ayrılmış bir ad alanı URI oluşan akıllı etiket için benzersiz bir tanımlayıcı ve bir etiket yazın.
  • caption
    Tür: System.String
    Akıllı etiket menüsünde görüntülenen akıllı etiket adı.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Excel.SmartTag
Yeni akıllı etiket.

Özel Durumlar

Exception Koşul
ArgumentException

smartTagTypeveya caption ya da nullnull başvuru (Visual Basic\'te Nothing) veya boş veya smartTagType geçerli değil.

Açıklamalar

Örnek için geçerli bir dize olarak smartTagType parametresi http://smarttags.contoso.com#TagName. İyi biçimlendirilmiş akıllı etiket türü dize boşluk içermeyen ve harf (a-z, a-z), bir alt çizgi (_) veya iki nokta (:).) başlatır

Akıllı etiketler hakkında daha fazla bilgi için bkz: Akıllı Etiketlere Genel Bakış ve Akıllı Etiketler Mimarisi.

Örnekler

Aşağıdaki kod örneği, bir akıllı etiket ve eylem Excel çalışma kitabı projesinde oluşturulması gösterilmiştir. Bu örneği kullanmak için ThisWorkbook sınıfından kodu çalıştırın.

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 Güvenliği

Ayrıca bkz.

Başvuru

Factory Arabirim

Microsoft.Office.Tools.Excel Ad Alanı