Metodo Factory.CreateSmartTag
Crea un oggetto SmartTag che rappresenta uno smart tag in un documento.
Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Sintassi
'Dichiarazione
Function CreateSmartTag ( _
smartTagType As String, _
caption As String, _
extension As ISmartTagExtension _
) As SmartTag
SmartTag CreateSmartTag(
string smartTagType,
string caption,
ISmartTagExtension extension
)
Parametri
- smartTagType
Tipo: System.String
Identificatore univoco per lo smart tag, composto da un URI dello spazio dei nomi e dal nome di un tipo di tag separati dal simbolo di cancelletto (#).
- caption
Tipo: System.String
Nome dello smart tag visualizzato nel menu Smart tag.
- extension
Tipo: Microsoft.Office.Tools.Word.ISmartTagExtension
Facoltativo.Oggetto estensione che definisce un sistema di riconoscimento personalizzato per lo smart tag.
Valore restituito
Tipo: Microsoft.Office.Tools.Word.SmartTag
Nuovo smart tag.
Eccezioni
| Eccezione | Condizione |
|---|---|
| ArgumentException | smartTagType o caption è nullriferimento null (Nothing in Visual Basic) o vuoto oppure smartTagType non è valido. |
Note
Un esempio di stringa valida per il parametro smartTagType è costituito da http://smarttags.contoso.com#TagName. Una stringa di tipo smart tag ben formata non contiene spazi vuoti e inizia con una lettera (a-z, A-Z), un carattere di sottolineatura (_) o due punti (:).
Per ulteriori informazioni sugli smart tag, vedere Cenni preliminari sugli smart tag e Architettura degli smart tag.
Esempi
Nell'esempio di codice seguente viene illustrato come creare uno smart tag e un'azione in un progetto di documento di Word. Per utilizzare questo esempio, eseguire il codice dalla classe 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);
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.