Factory.CreateSmartTag メソッド
文書内のスマート タグを表す SmartTag オブジェクトを作成します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.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.Word.ISmartTagExtension
省略可能。スマート タグのカスタム レコグナイザーを定義する拡張されたオブジェクトです。
戻り値
型: Microsoft.Office.Tools.Word.SmartTag
新しいスマート タグです。
例外
例外 | 条件 |
---|---|
ArgumentException | smartTagType または caption が nullnull 参照 (Visual Basic では Nothing) または空のいずれかであるか、smartTagType が無効です。 |
解説
smartTagType パラメーターの有効な文字列の例は http://smarttags.contoso.com#TagName です。 整形式のスマート タグ型の文字列に空白は含まれません。この文字列は、文字 (a ~ z および A ~ Z)、アンダースコア (_)、またはコロン (:) で始まります。
スマート タグの詳細については、「スマート タグの概要」および「スマート タグのアーキテクチャ」を参照してください。
例
次のコード例は、Word 文書プロジェクトでスマート タグとアクションを作成する方法を示しています。 このコード例を使用するには、ThisDocument クラスから実行します。
Dim simpleSmartTag As Microsoft.Office.Tools.Word.SmartTag =
Globals.Factory.CreateSmartTag(
"www.microsoft.com/Demo#DemoSmartTag",
"Test Smart Tag")
Dim simpleAction As Microsoft.Office.Tools.Word.Action =
Globals.Factory.CreateAction("Test Action")
simpleSmartTag.Terms.Add("blue")
simpleSmartTag.Actions = New Microsoft.Office.Tools.Word.Action() { _
simpleAction}
Me.VstoSmartTags.Add(simpleSmartTag)
Microsoft.Office.Tools.Word.SmartTag simpleSmartTag =
Globals.Factory.CreateSmartTag(
"www.microsoft.com/Demo#DemoSmartTag",
"Test Smart Tag");
Microsoft.Office.Tools.Word.Action simpleAction =
Globals.Factory.CreateAction("Test Action");
simpleSmartTag.Terms.Add("blue");
simpleSmartTag.Actions = new Microsoft.Office.Tools.Word.Action[] {
simpleAction };
this.VstoSmartTags.Add(simpleSmartTag);
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。