Elemento host AddIn
Actualización: Julio de 2008
Se aplica a |
|---|
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto
Versión de Microsoft Office
Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto. |
La clase Microsoft.Office.Tools.AddIn es el elemento host para los complementos en el nivel de la aplicación que se crean mediante Visual Studio Tools para Office. Un elemento host es una clase en una solución de Visual Studio Tools para Office que proporciona el punto de entrada para el código.
Descripción de las clases AddIn y ThisAddIn
La clase AddIn proporciona la funcionalidad básica que comparten todos los complementos de Visual Studio Tools para Office. Sin embargo, no debe crear instancias explícitamente de esta clase ni usarla directamente en el código.
En su lugar, utilice la clase ThisAddIn. Visual Studio Tools para Office genera esta clase en el proyecto de complemento para que sirva como vínculo de comunicación entre la aplicación de Microsoft Office y el código del complemento. La clase ThisAddIn se deriva de AddIn. Visual Studio Tools para Office crea automáticamente instancias de esta clase cuando una aplicación de Microsoft Office carga el complemento.
La clase ThisAddIn proporciona una ubicación en la que puede empezar a escribir el código del proyecto. También puede utilizar ThisAddIn para realizar tareas como obtener acceso al modelo de objetos de la aplicación host. Para obtener más información, vea Programar complementos de nivel de aplicación.
Usar AddIn y ThisAddIn en los proyectos de complemento de Outlook 2007
Los proyectos de complemento para Microsoft Office Outlook 2007 usan un elemento host diferente, Microsoft.Office.Tools.Outlook.OutlookAddIn. Esta clase deriva de AddIn y agrega funcionalidad adicional para admitir las áreas de formulario. Para obtener más información sobre las áreas de formulario, vea Crear áreas de formulario de Outlook.
En los proyectos de complemento para Outlook 2007, la clase ThisAddIn deriva de OutlookAddIn. La clase ThisAddIn se usa en los complementos de Outlook 2007 de la misma manera que se usa en los complementos para otras aplicaciones de Microsoft Office.
Miembros que se utilizan para diversas tareas
En la tabla siguiente se describen las tareas más comunes y se muestran los miembros de la clase ThisAddIn que puede utilizar para realizarlas.
Tarea |
Miembro que se utiliza |
|---|---|
Ejecute el código para inicializar el complemento cuando se carga. |
Agregue código al método ThisAddIn_Startup. Éste es el controlador de eventos predeterminado para el evento Startup. Para obtener más información, vea Eventos de proyectos de Visual Studio Tools para Office. |
Ejecute el código para limpiar los recursos usados por el complemento antes de que se descargue. |
Agregue código al método ThisAddIn_Shutdown. Éste es el controlador de eventos predeterminado para el evento Shutdown. Para obtener más información, vea Eventos de proyectos de Visual Studio Tools para Office. |
Automatizar la aplicación host mediante el acceso al modelo de objetos. |
Utilice el campo Application de la clase ThisAddIn. Devuelve una instancia de la clase Application de la aplicación con la que funciona el complemento. Para obtener más información, consulte Programar complementos de nivel de aplicación. |
Crear una etiqueta inteligente que se puede reconocer en cualquier documento de Word o libro de Excel que esté abierto. Esta característica es nueva en Visual Studio 2008 Service Pack 1. |
Utilice el campo VstoSmartTags de la clase ThisAddIn. Este campo sólo está disponible en proyectos de complemento para Excel 2007 y Word 2007 que se crean después de instalar el SP1. Para obtener más información, vea Información general sobre etiquetas inteligentes. |
Exponga los objetos del complemento en otras soluciones de Microsoft Office. |
Reemplace el método RequestComAddInAutomationService. Para obtener más información, consulte Llamar a código en complementos de nivel de aplicación desde otras soluciones de Office. |
Personalice una característica de Microsoft Office System 2007 implementando una interfaz de extensibilidad. |
Invalide el método RequestService para devolver una instancia de una clase que implemente la interfaz. Para obtener más información, vea Personalizar características de la interfaz de usuario mediante interfaces de extensibilidad. .gif "Nota") Nota:
Para personalizar la interfaz de usuario de la cinta de opciones, también puede invalidar el método CreateRibbonExtensibilityObject.
|
Vea también
Tareas
Tutorial: Llamar a código de VBA en un complemento de nivel de aplicación
Conceptos
Programar complementos de nivel de aplicación
Personalizar características de la interfaz de usuario mediante interfaces de extensibilidad
Llamar a código en complementos de nivel de aplicación desde otras soluciones de Office
Introducción a la programación de complementos de nivel de aplicación
Eventos de proyectos de Visual Studio Tools para Office
Historial de cambios
Fecha |
Historial |
Motivo |
|---|---|---|
|
Julio de 2008 |
Se ha añadido información sobre cómo agregar etiquetas inteligentes a documentos utilizando complementos en el nivel de la aplicación. |
Cambio de características de SP1. |