Complementos COM de Excel y complementos de automatización

Complementos COM

Los complementos COM presentan al desarrollador una forma de ampliar la funcionalidad de las aplicaciones de Office para tareas personalizadas. Los complementos COM se usan normalmente para automatizar Excel en respuesta a un clic de un botón de la barra de comandos, un formulario o cuadro de diálogo, o algún otro evento específico de Excel, como abrir o cerrar libros o escribir datos en hojas de cálculo. Las funciones de complemento COM no se pueden llamar directamente desde fórmulas de celda en hojas de cálculo.

Un complemento COM es un servidor COM en proceso (un archivo DLL de ActiveX) que debe implementar la interfaz IDTExensibility2. Todos los complementos COM deben implementar cada uno de los cinco métodos de esta interfaz: OnConnection, OnStartupComplete, OnAddinsUpdate, OnBeginShutDown y OnDisconnection.

Cuando se instala un complemento COM en el sistema de un usuario, se crean entradas del Registro para el complemento. Además del registro COM normal, se registra un complemento COM para cada aplicación de Office en la que se ejecuta. Los complementos COM usados por Excel se registran en la clave del Registro siguiente:

            
HKEY_CURRENT_USER\Software\Microsoft\Office\Excel\Addins\ 

Esta clave contiene una subclave para cada complemento COM instalado. El nombre de la subclave es el ProgID del complemento COM. La subclave de un complemento COM también contiene valores que describen el nombre descriptivo, la descripción y el comportamiento de carga del complemento COM. El comportamiento de carga describe cómo se carga el complemento en Excel: cargado en el inicio, cargado solo en el siguiente inicio, cargado a petición o no cargado.

Los complementos COM también se pueden cargar y descargar a través de la interfaz de usuario de Excel. Para ello, siga estos pasos:

1. En el menú Ver, seleccione Barras de herramientas y, a continuación, haga clic en Personalizar.

2. En el cuadro de diálogo Barras de herramientas, haga clic en la pestaña Avanzadas. En la lista de categorías, selecciona Herramientas. Busque Complementos COM en la lista de comandos y arrastre el comando a un menú o a la barra de comandos de su elección. Cierre el cuadro de diálogo Barras de herramientas.

3. Haga clic en el comando Complementos COM que agregó para mostrar el cuadro de diálogo Complementos COM. En el cuadro de diálogo se muestran todos los complementos COM que están instalados en el sistema y se seleccionan los complementos COM que están cargados actualmente.

Los complementos COM también se pueden cargar y descargar a través de la interfaz de usuario de Excel. Para ello, siga estos pasos:

1. Haga clic en el botón de Microsoft Office y luego en Opciones de Excel.

2. Haga clic en Complementos.

3. En Administrar, haga clic en Complementos COM y, a continuación, haga clic en Ir .
   
   En el cuadro de diálogo Complementos COM se muestran todos los complementos COM que están instalados en el equipo. Los complementos COM que están cargados actualmente están seleccionados.

Para obtener más información, consulte el siguiente sitio web de Microsoft:

Información general sobre la plataforma de complementos de Office

Complementos de automatización

Además de los complementos COM, Excel admite complementos de automatización. Los complementos de automatización se basan en complementos COM en que las funciones de los complementos de automatización se pueden llamar desde fórmulas de hojas de cálculo de Excel. Los complementos COM deben ser servidores COM en proceso que admitan la interfaz IDTExtensibility2; sin embargo, los complementos de automatización pueden ser servidores COM en proceso o fuera de proceso y la implementación de IDTExtensibility2 es opcional.

Para usar funciones de un complemento de automatización en Excel, siga estos pasos:

1. En el menú Herramientas, haga clic en Complementos.

2. En el cuadro de diálogo Add-Ins, haga clic en Automatización. En la lista de servidores COM registrados, seleccione el complemento de automatización y haga clic en Aceptar.

3. El complemento de automatización aparece en el cuadro de diálogo Complementos. Haga clic en Aceptar para cerrar el cuadro de diálogo Add-Ins.

Para usar funciones de un complemento de automatización en Excel 2007 y versiones posteriores, siga estos pasos:

1. Haga clic en el botón de Microsoft Office y, luego, en Opciones de Excel.

2. Haga clic en Complementos.

3. En Administrar, haga clic en Complementos de Excel y, a continuación, haga clic en Ir.

4. En el cuadro de diálogo Complementos , haga clic en Automatización. En la lista de servidores COM registrados, haga clic en el complemento de automatización y, a continuación, haga clic en Aceptar.
   
   El complemento de automatización aparece en el cuadro de diálogo Complementos . Haga clic en Aceptar para cerrar el cuadro de diálogo Complementos .

Cuando agrega a la lista en el cuadro de diálogo Add-Ins o al seleccionar y borrar complementos en la lista, Excel almacena los cambios en el Registro. En primer lugar, Excel usa la siguiente configuración del Registro para determinar si se carga o no un complemento de automatización en la lista complementos:

 Excel 2002
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\10.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"

 Excel 2003
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"
Excel 2007
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"

Nota: Cambie el número de versión de Office según la versión que use.


El modificador /A que se usa en el valor de cadena es nuevo para Excel y versiones anteriores y se usa específicamente para cargar complementos de automatización. Todos los complementos de automatización se cargan a petición; no hay ninguna configuración que pueda cambiar el comportamiento de carga de un complemento de automatización.

Cuando un complemento de automatización que aparece en el cuadro de diálogo Add-Ins está desactivado, se crea una subclave con un nombre igual al ProgID del complemento en la clave del Registro siguiente:

HKEY_CURRENT_USER\Software\Microsoft\Office\10.0\Excel\Add-in Manager Excel 2003:



HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Add-in Manager
HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Add-in Manager Esta configuración del Registro garantiza que los complementos de automatización que haya agregado a la lista de complementos se conserven en la lista incluso cuando haya elegido no cargarlos.

Para obtener más información, consulte el siguiente sitio web de Microsoft:

Información general sobre la plataforma de complementos de Office

Complementos de automatización que implementan IDTExtensibility2

Como se mencionó anteriormente, un complemento de automatización puede implementar IDTExtensibility2, pero no es necesario para que Excel llame a las funciones del complemento desde una hoja de cálculo. Si necesita que el complemento automation obtenga una referencia a la instancia de Excel, puede implementar IDTExtensibility2 y usar el parámetro Application de OnConnection para automatizar Excel.

Un complemento de automatización que implementa
IDTExtensibility2 se puede cargar en la interfaz de usuario de Excel mediante el cuadro de diálogo Add-Ins COM y el cuadro de diálogo Add-Ins. A continuación se describe el comportamiento de un complemento de automatización en función de si se carga en uno de estos cuadros de diálogo o en ambos:

• Cargado solo en el cuadro de diálogo Complementos.
  
  El complemento se carga a petición. Las funciones del complemento pueden llamarse desde fórmulas de una hoja de cálculo.

• Cargado solo en el cuadro de diálogo Complementos COM.
  
  El complemento se carga como un complemento COM y su comportamiento de carga se determina a partir de la configuración del Registro. No se puede llamar a las funciones del complemento desde fórmulas de una hoja de cálculo.

• Cargado en el cuadro de diálogo Complementos COM y en el cuadro de diálogo Complementos.
  
  Se cargan dos instancias independientes del complemento. Una instancia se carga como un complemento COM y la otra instancia se carga como un complemento de Automation. La instancia del complemento COM usa el comportamiento de carga indicado en el Registro; la instancia del complemento de automatización se carga a petición. Las dos instancias funcionan independientemente y no comparten variables globales.

Como los complementos de automatización se cargan a petición, Es posible que Excel intente cargar el complemento mientras está en modo de edición de celdas. Por lo tanto, al desarrollar un complemento de automatización compatible con IDTExtensibility2, debe tener cuidado de no hacer nada que intente cambiar el estado de Excel mientras se carga el complemento. Para más información al respecto, consulte el artículo siguiente en Microsoft Knowledge Base:

284876 ERROR: Excel produce un error al cargar

Add-In de automatización (c) Microsoft Corporation 2001, Todos los derechos reservados. Contribuciones de Lori B. Turner, Microsoft Corporation.