Factory.CreateSmartTag (Método)
Crea un objeto SmartTag que representa una etiqueta inteligente de un documento.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Function CreateSmartTag ( _
smartTagType As String, _
caption As String, _
extension As ISmartTagExtension _
) As SmartTag
SmartTag CreateSmartTag(
string smartTagType,
string caption,
ISmartTagExtension extension
)
Parámetros
- smartTagType
Tipo: System.String
Identificador único de la etiqueta inteligente, compuesto por el identificador URI de un espacio de nombres y un nombre de tipo de etiqueta separados por una almohadilla (#).
- caption
Tipo: System.String
Nombre de la etiqueta inteligente mostrado en el menú de etiquetas inteligentes.
- extension
Tipo: Microsoft.Office.Tools.Word.ISmartTagExtension
Opcional.Objeto de extensión que define un reconocedor personalizado para la etiqueta inteligente.
Valor devuelto
Tipo: Microsoft.Office.Tools.Word.SmartTag
Nueva etiqueta inteligente.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentException | smartTagType o caption es nullreferencia null (Nothing en Visual Basic) o está vacío, o bien smartTagType no es válido. |
Comentarios
Un ejemplo de una cadena válida para el parámetro smartTagType es http://smarttags.contoso.com#NombreEtiqueta. Una cadena de tipo de etiqueta inteligente correctamente formada, no debe contener espacios en blanco, y debe comenzar con una letra (a-z, a-Z), un carácter de subrayado (_) o dos puntos (:).
Para obtener más información sobre las etiquetas inteligentes, vea Información general sobre etiquetas inteligentes y Arquitectura de las etiquetas inteligentes.
Ejemplos
En el siguiente ejemplo de código se muestra cómo crear una etiqueta inteligente y una acción en un proyecto de documento de Word. Para usar este ejemplo, ejecute el código desde la clase 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);
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.