¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

Cómo: Crear etiquetas inteligentes con reconocedores personalizados en Word y .NET Framework 4

Visual Studio 2010

En proyectos Word destinados a .NET Framework 4, puede controlar cómo reconoce Word las etiquetas inteligentes en documentos implementando la interfaz ISmartTagExtension.

Para ejecutar una etiqueta inteligente, los usuarios finales deben tener las etiquetas inteligentes habilitadas en Word o en Excel. Para obtener más información, vea Cómo: Habilitar las etiquetas inteligentes en Word y en Excel.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Word 2007. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Para agregar una etiqueta inteligente con un reconocedor personalizado a un documento de Word

  1. Cree un proyecto de nivel de documento o de nivel de aplicación para Word 2007. Para obtener más información, vea Cómo: Crear proyectos de Office en Visual Studio.

  2. Agregue una referencia al ensamblado Microsoft.Office.Interop.SmartTag (versión 12.0.0.0) desde la pestaña .NET del cuadro de diálogo Agregar referencia.

  3. Agregue un archivo de clase al proyecto y cree una clase que implemente la interfaz ISmartTagExtension.

  4. En la nueva clase, cree un objeto SmartTag que representa la etiqueta inteligente y cree uno o más objetos Action que representan las acciones de etiqueta inteligente. Utilice los métodos Globals.Factory.CreateSmartTag y Globals.Factory.CreateAction para crear estos objetos.

  5. Implemente el método Recognize y escriba su propio comportamiento de reconocimiento personalizado.

    Su implementación debe llamar al método PersistTag del parámetro context para que Word reconozca la etiqueta inteligente.

  6. Implemente la propiedad ExtensionBase para devolver el objeto SmartTag.

  7. Cree controladores de eventos para responder al evento Click y, opcionalmente, al evento BeforeCaptionShow, de las acciones creadas.

  8. En el archivo de código del documento del proyecto, agregue la instancia de etiqueta inteligente a la propiedad VstoSmartTags de la clase ThisDocument (para un proyecto en el nivel del documento) o la propiedad VstoSmartTags de la clase ThisAddIn (para un proyecto en el nivel de la aplicación).

En el ejemplo de código siguiente se muestra cómo crear una etiqueta inteligente personalizada en un documento de Word. En el ejemplo se implementa el método Recognize para reconocer los términos sales y organization. El método Recognize agrega un par de clave y valor a la colección de propiedades principales de la etiqueta inteligente. El método llama, a continuación, al método PersistTag para reconocer la etiqueta inteligente y guardar la nueva propiedad de etiqueta inteligente.

Para probar el ejemplo, escriba las palabras sales y organization en lugares diferentes del documento y, a continuación, pruebe las acciones de la etiqueta inteligente. Una acción muestra el valor de la propiedad correspondiente para el término reconocido y la otra, muestra el espacio de nombres de la etiqueta inteligente y el título.


using System;
using System.Windows.Forms;
using Microsoft.Office.Interop.SmartTag;
using Microsoft.Office.Tools.Word;

namespace CustomSmartTagExample
{
    public class CustomSmartTag : ISmartTagExtension
    {
        // Declare the smart tag.
        Microsoft.Office.Tools.Word.SmartTag smartTagDemo;

        // Declare actions for this smart tag.
        private Microsoft.Office.Tools.Word.Action Action1;
        private Microsoft.Office.Tools.Word.Action Action2;

        public CustomSmartTag()
        {
            this.smartTagDemo = Globals.Factory.CreateSmartTag(
                "http://www.contoso.com/Demo#DemoSmartTag", "Custom Smart Tag", this);

            Action1 = Globals.Factory.CreateAction("Display property value");
            Action2 = Globals.Factory.CreateAction("Display smart tag details");

            smartTagDemo.Terms.AddRange(new string[] { "sales", "organization" });
            smartTagDemo.Actions = new Microsoft.Office.Tools.Word.Action[] { Action1, Action2 };

            Action1.Click += new ActionClickEventHandler(Action1_Click);
            Action2.Click += new ActionClickEventHandler(Action2_Click);
        }

        void ISmartTagExtension.Recognize(string text, ISmartTagRecognizerSite site, ISmartTagTokenList tokenList, 
            SmartTagRecognizeContext context)
        {

            foreach (string term in smartTagDemo.Terms)
            {
                // Search the text for the current smart tag term.
                int index = text.IndexOf(term, 0);

                while (index >= 0)
                {
                    // Create a smart tag token and a property bag for the recognized term.
                    ISmartTagProperties propertyBag = site.GetNewPropertyBag();

                    // Write a new property value.
                    string key = "Key1";
                    propertyBag.Write(key, DateTime.Now.ToString());

                    // Attach the smart tag to the term in the document
                    context.PersistTag(index, term.Length, propertyBag);

                    // Increment the index and then find the next instance of the smart tag term.
                    index += term.Length;
                    index = text.IndexOf(term, index);
                }
            }
        }

        // This action displays the property value for the term.
        private void Action1_Click(object sender,
            Microsoft.Office.Tools.Word.ActionEventArgs e)
        {
            ISmartTagProperties propertyBag = e.Properties;
            string key = "Key1";
            MessageBox.Show("The corresponding value of " + key + " is: " + propertyBag.get_Read(key));
        }

        // This action displays smart tag details.
        private void Action2_Click(object sender,
            Microsoft.Office.Tools.Word.ActionEventArgs e)
        {
            MessageBox.Show("The current smart tag caption is '" +
                smartTagDemo.Caption + "'. The current smart tag type is '" + smartTagDemo.SmartTagType + "'.");
        }


        public Microsoft.Office.Tools.Word.SmartTag Base
        {
            get { return smartTagDemo; }
        }

        public object ExtensionBase
        {
            get { return smartTagDemo; }
        }

    }
}


  • En el proyecto, agregue una referencia a la Biblioteca de tipos de Etiquetas inteligentes de Microsoft 2.0 de la ficha COM del cuadro de diálogo Agregar referencia. Compruebe que la propiedad Copy Local de la referencia es false. Si es true, la referencia no se aplica al ensamblado de interoperabilidad primario correcto y se debe instalar el ensamblado de los discos de instalación de Microsoft Office. Para obtener más información, vea Cómo: Instalar ensamblados de interoperabilidad primarios de Office.

  • Coloque el código de ejemplo en un nuevo archivo de clase denominado CustomSmartTag.

  • En C#, cambie el espacio de nombres para que coincida con el nombre del proyecto.

  • Agregue Imports (en Visual Basic) o instrucciones using (en C#) para los espacios de nombres Microsoft.Office.Tools.Word y Microsoft.Office.Interop.SmartTag en la parte superior del archivo de clases.

  • Agregue el código siguiente al controlador de eventos ThisAddIn_Startup o ThisDocument_Startup en su proyecto. Este código agrega la etiqueta inteligente personalizada al documento.

    Me.VstoSmartTags.Add(New CustomSmartTag().Base)
    

    this.VstoSmartTags.Add(new CustomSmartTag().Base);
    

Para ejecutar la etiqueta inteligente, las etiquetas inteligentes deben estar habilitadas en Word. Para obtener más información, vea Cómo: Habilitar las etiquetas inteligentes en Word y en Excel.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft