Función RUNADDON

Ejecuta un complemento o una macro en un proyecto de Microsoft Visual Basic para Aplicaciones (VBA).

Sintaxis

RUNADDON(" cadena ")

Parameters

Name Necesario/Opcional Tipo de datos Descripción
string
Obligatorio
String
Nombre de un complemento de la colección Addons o de una macro de un proyecto VBA.

Comentarios

Si el proyecto del documento que contiene la llamada a la función RUNADDON (u otro proyecto, si se hace referencia a él) no tiene una macro (un procedimiento sin argumentos) denominada cadena, Microsoft Visio ejecuta el complemento llamado cadena. Si no se puede encontrar ningún complemento denominado cadena, Visio no realiza ninguna acción ni devuelve ningún error. (Puede usar la propiedad TraceFlags para supervisar los procedimientos y complementos que intente ejecutar Visio).

Cuando se llama a un procedimiento en un módulo estándar, se recomienda anteponer a la cadena el nombre del módulo que contiene el procedimiento (por ejemplo, nombreMódulo.nombreProc), ya que puede haber más de un procedimiento con el mismo nombre en un mismo módulo.

Para llamar a un procedimiento de otro proyecto distinto del documento que contiene la llamada a la función RUNADDON, utilice la sintaxis nombreProy.nombreMód.nombreProc (es necesario haber establecido explícitamente una referencia a nombreProy en el proyecto VBA).

Nota:

A partir de Visio 2002, la función RUNADDON no es capaz de ejecutar una cadena que contenga código VBA arbitrario. El código pasado anteriormente a la función RUNADDON se puede mover a un procedimiento de un proyecto VBA de un documento, llamado desde la función RUNADDON.

Para obtener más información acerca de cómo ejecutar código en Visio, vea Acerca de la configuración de seguridad y la ejecución de código en Visio en esta Referencia de ShapeSheet.

En versiones anteriores de Visio, esta función se denominaba _RUNADDON. La versión 4.0 de Visio y las posteriores aceptan cualquiera de las dos denominaciones.

Ejemplo 1

RUNADDON("Calendar.exe")

Inicia un complemento denominado Calendar.exe.

Ejemplo 2

RUNADDON("Colocar formas en matriz")

Inicia el complemento (implementado por VSL) denominado Colocar formas en matriz.

Ejemplo 3

RUNADDON("ThisDocument.ReportStatistics")

Llama a la macro ReportStatistics del módulo ThisDocument en el proyecto del documento que contiene esta llamada a función.

Nota:

Para invocar una macro del módulo ThisDocument, es preciso anteponer "ThisDocument" a la cadena, como muestra el ejemplo.

Ejemplo 4

RUNADDON(" ModuleName . ReportStatistics")

Llama a la macro ReportStatistics de NombreMódulo en el proyecto del documento que contiene esta llamada a función.