ApplicationFactory.CreateSmartTag, méthode
Crée un objet SmartTag qui représente une balise active d'un document. Ce type ou ce membre vise à être utilisé uniquement dans les projets pour la version 2007 de Microsoft Office System. Les balises actives sont déconseillées dans Office 2010.
.
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
Optionnel.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 (:).
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.