Factory.CreateSmartTag-Methode
Erstellt ein SmartTag-Objekt, das ein Smarttag in einem Dokument darstellt.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Syntax
'Declaration
Function CreateSmartTag ( _
smartTagType As String, _
caption As String, _
extension As ISmartTagExtension _
) As SmartTag
SmartTag CreateSmartTag(
string smartTagType,
string caption,
ISmartTagExtension extension
)
Parameter
- smartTagType
Typ: System.String
Eindeutiger Bezeichner für das Smarttag, der aus einem Namespace-URI und einem Tagtypnamen besteht, die durch ein Nummernzeichen (#) getrennt sind.
- caption
Typ: System.String
Der Name des Smarttags, der im Smarttagmenü angezeigt wird.
- extension
Typ: Microsoft.Office.Tools.Word.ISmartTagExtension
Optional.Ein Erweiterungsobjekt, das eine benutzerdefinierte Erkennung für das Smarttag definiert.
Rückgabewert
Typ: Microsoft.Office.Tools.Word.SmartTag
Das neue Smarttag.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | smartTagType oder caption ist nullNULL-Verweis (Nothing in Visual Basic) oder leer, oder smartTagType ist nicht gültig. |
Hinweise
Ein Beispiel für eine gültige Zeichenfolge für den smartTagType-Parameter ist http://smarttags.contoso.com#TagName. Eine wohlgeformte Smarttag-Typzeichenfolge enthält keine Leerzeichen, und er beginnt mit einem Buchstaben (a-z, A-Z), einem Unterstrich (_) oder einem Doppelpunkt (:).
Weitere Informationen zu Smarttags finden Sie unter Übersicht über Smarttags und Smarttagarchitektur.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie ein Smarttag und eine Aktion in einem Word-Dokumentprojekt erstellt werden. Um dieses Codebeispiel verwenden zu können, müssen Sie den Code in der ThisDocument-Klasse ausführen.
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-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.