Programar complementos de nivel de aplicación
Actualización: noviembre 2007
Se aplica a |
|---|
La información de este tema sólo se aplica a los proyectos de Visual Studio Tools para Office y versiones de Microsoft Office especificados. 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. |
Al extender una aplicación de Microsoft Office mediante la creación de un complemento de Visual Studio Tools para Office, escribe código directamente en la clase ThisAddIn del proyecto. Puede utilizar esta clase para realizar tareas como tener acceso al modelo de objetos de la aplicación host de Microsoft Office, personalizar la interfaz de usuario de la aplicación y exponer objetos del complemento a otras soluciones de Office.
Para obtener información general sobre los complementos de nivel de aplicación y otros tipos de soluciones que puede crear mediante Visual Studio Tools para Office, vea Información general sobre el desarrollo de soluciones de Office.
Escribir código en el proyecto de complemento
Puede comenzar a escribir el código del complemento en la clase ThisAddIn. Visual Studio Tools para Office genera automáticamente esta clase en el archivo de código ThisAddIn.vb (en Visual Basic) o ThisAddIn.cs (en C#) del proyecto de complemento.
La clase ThisAddIn incluye dos controladores de eventos predeterminados. Para ejecutar el código cuando se cargue el complemento, agregue código al controlador del evento ThisAddIn_Startup. Para ejecutar el código justo antes de que se descargue el complemento, agregue código al controlador del evento ThisAddIn_Shutdown. Para obtener más información, vea Eventos de proyectos de Visual Studio Tools para Office.
La clase ThisAddIn deriva la mayoría de sus características de la clase AddIn. AddIn proporciona funcionalidad básica compartida por todos los complementos de Visual Studio Tools para Office. Para obtener más información sobre la clase AddIn, vea Elemento host AddIn.
Tener acceso al modelo de objetos de la aplicación host
Para tener acceso al modelo de objetos de la aplicación host, utilice el campo Application de la clase ThisAddIn. Este campo devuelve un objeto que representa la instancia actual de la aplicación host.
El ejemplo de código siguiente muestra cómo utilizar el campo Application para crear un nuevo libro en un complemento para Microsoft Office Excel. Este ejemplo está diseñado para su ejecución desde la clase ThisAddIn.
Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()
Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);
Para conseguir el mismo resultado desde fuera de la clase ThisAddIn, utilice el objeto Globals para tener acceso a la clase ThisAddIn. Para obtener más información acerca del objeto Globals, vea Acceso global a objetos en proyectos de Visual Studio Tools para Office.
Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()
Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);
En la tabla siguiente se muestra el tipo de valor devuelto para el campo Application en cada proyecto de complemento.
Aplicación host |
Tipo de valor devuelto |
|---|---|
Microsoft Office Excel |
|
Microsoft Office InfoPath |
Microsoft.Office.Interop.InfoPath.Application |
Microsoft Office Outlook |
Microsoft.Office.Interop.Outlook.Application |
Microsoft Office PowerPoint |
Microsoft.Office.Interop.PowerPoint.Application |
Microsoft Office Project |
Microsoft.Office.Interop.MSProject.Application |
Microsoft Office Visio |
Microsoft.Office.Interop.Visio.Application |
Microsoft Office Word |
Personalizar la interfaz de usuario de aplicaciones de Microsoft Office
Puede personalizar mediante programación la interfaz de usuario de las aplicaciones de Microsoft Office con un complemento de nivel de aplicación. En las aplicaciones de Microsoft Office 2003, las características de la interfaz de usuario que se pueden personalizar incluyen los menús y las barras de herramientas. Las aplicaciones de Microsoft Office System 2007 disponen de algunas características de interfaz de usuario diferentes que se pueden personalizar. Estas características incluyen la cinta de opciones, paneles de tareas personalizados y áreas de formulario de Outlook. Para obtener más información, vea Personalización de la interfaz de usuario de Office.
Visual Studio Tools para Office proporciona diseñadores y clases que puede utilizar para crear paneles de tareas personalizados, personalizaciones de la cinta de opciones y áreas de formulario de Outlook. Estos diseñadores y clases le ayudan a simplificar el proceso de personalización de estas características. Para obtener más información, vea Información general sobre los paneles de tareas personalizados, diseñador de la cinta de opciones y Crear áreas de formulario de Outlook.
Si desea personalizar una de estas características de una forma no admitida por las clases y los diseñadores de Visual Studio Tools para Office, también puede personalizar estas características mediante la implementación de una interfaz de extensibilidad en el complemento. Para obtener más información, vea Personalizar características de la interfaz de usuario mediante interfaces de extensibilidad.
A partir de Visual Studio 2008 Service Pack 1 (SP1), también puede modificar la interfaz de usuario de los documentos de Word y libros de Excel generando elementos host que extienden el comportamiento de los documentos y libros. Esto le permite agregar controles administrados y etiquetas inteligentes de Visual Studio Tools para Office a los documentos y las hojas de cálculo. Para obtener más información, vea Ampliar documentos de Word y libros de Excel en complementos en el nivel de la aplicación en tiempo de ejecución.
Llamar a código en complementos de nivel de aplicación desde otras soluciones de Office
Puede exponer los objetos del complemento a otras soluciones de Office. Esto resulta útil si el complemento proporciona un servicio que desea habilitar para que lo usen otras soluciones de Office. Por ejemplo, si tiene un complemento para Microsoft Office Excel que realiza cálculos en datos financieros de un servicio web, otras soluciones de Office pueden realizar estos cálculos mediante una llamada en tiempo de ejecución al complemento de Excel.
Para obtener más información, vea Llamar a código en complementos de nivel de aplicación desde otras soluciones de Office.
Vea también
Tareas
Tutorial: Llamar a código de VBA en un complemento de nivel de aplicación
Cómo: Crear proyectos de Visual Studio para Office
Conceptos
Desarrollar soluciones de Office
Llamar a código en complementos de nivel de aplicación desde otras soluciones de Office
Personalizar características de la interfaz de usuario mediante interfaces de extensibilidad