ApplicationFactory.CreateSmartTag メソッド
ワークシートのスマート タグを表す SmartTag オブジェクトを作成します。この型またはメンバーは 2007 Microsoft Office システムのプロジェクト専用です。スマート タグは Office 2010 では使用されていません。
.
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
Function CreateSmartTag ( _
smartTagType As String, _
caption As String, _
extension As ISmartTagExtension _
) As SmartTag
SmartTag CreateSmartTag(
string smartTagType,
string caption,
ISmartTagExtension extension
)
パラメーター
- smartTagType
型 : System.String
スマート タグ用の一意の識別子です。名前空間の URI とタグの型名とをシャープ記号で区切って構成されます。
- caption
型 : System.String
スマート タグ メニューに表示される、スマート タグの名前です。
- extension
型 : Microsoft.Office.Tools.Excel.ISmartTagExtension
省略可能です。スマート タグのカスタム レコグナイザーを定義する拡張されたオブジェクトです。
戻り値
型 : Microsoft.Office.Tools.Excel.SmartTag
新しいスマート タグです。
例外
| 例外 | 条件 |
|---|---|
| ArgumentException | smartTagType または caption が nullnull 参照 (Visual Basic では Nothing) または空のいずれかであるか、smartTagType が無効です。 |
解説
smartTagType パラメーターの有効な文字列の例は http://smarttags.contoso.com#TagName です。整形式のスマート タグ型の文字列に空白は含まれません。この文字列は、文字 (a ～ z および A ～ Z)、アンダースコア (_)、またはコロン (:) で始まります。
例
次のコード例は、Excel アドイン プロジェクトでスマート タグとアクションを作成する方法を示しています。このコード例を使用するには、ThisAddIn クラスから実行します。
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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。