ApplicationFactory.CreateSmartTag Yöntem
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ı.
- extension
Tür: Microsoft.Office.Tools.Excel.ISmartTagExtension
İsteğe Bağlı.Akıllı etiket için özel bir tanıyıcı tanımlayan uzantı nesnesi.
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 eklenti projesinde ise oluşturulması gösterilmiştir. Bu örneği kullanmak için ThisAddIn 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
- Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. kısmen güvenilir kod tarafından Kitaplıklar kullanma.