ApplicationFactory.CreateSmartTag, méthode
Crée un objet SmartTag qui représente une balise active d'un document.
Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)
Syntaxe
'Déclaration
Function CreateSmartTag ( _
smartTagType As String, _
caption As String, _
extension As ISmartTagExtension _
) As SmartTag
SmartTag CreateSmartTag(
string smartTagType,
string caption,
ISmartTagExtension extension
)
Paramètres
- smartTagType
Type : System.String
Identificateur unique de la balise active, composé d'un URI d'espace de noms et d'un nom de type de balise séparés par un signe dièse (#).
- caption
Type : System.String
Nom de la balise active, qui est affiché dans le menu Balise active.
- extension
Type : Microsoft.Office.Tools.Word.ISmartTagExtension
Facultatif.Objet d'extension qui définit un module de reconnaissance personnalisé pour la balise active.
Valeur de retour
Type : Microsoft.Office.Tools.Word.SmartTag
Nouvelle balise active.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | smartTagType ou caption est nullune référence null (Nothing en Visual Basic) ou vide, ou smartTagType n'est pas valide. |
Notes
Un exemple de chaîne valide pour le paramètre smartTagType est http://smarttags.contoso.com#NomBalise. Une chaîne de type de balise active correcte ne contient pas d'espace blanc et commence par une lettre (a-z, A-Z), un trait de soulignement (_) ou le signe deux-points (:).
Pour plus d'informations sur les balises actives, consultez Vue d'ensemble des balises actives et Architecture des balises actives.
Exemples
L'exemple de code suivant montre comment créer une balise active et une action dans un projet de complément Word. Pour utiliser cet exemple, exécutez le code à partir de la classe ThisAddIn.
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);
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.