Funciones de dll

General » Asistente de fórmulas » Funciones de dll

Funciones de dll
Una librería externa es un objeto visual permite declarar una librería de enlace dinámico externa y sus funciones, a las que podremos invocar desde distintos puntos del proyecto.

Para activar/desactivar la lista de funciones de dll del asistente para la creación de fórmulas pulsaremos el botón del editor de fórmulas.

En esta pestaña encontraremos las librerías externas declaradas tanto en proyecto en curso con en los proyectos heredados.

Para ejecutar una funcón de una librería externa no tendremos más que incluirla dentro de una fórmula.
Para elllo desplegaremos el nodo de la librería externa cuya función queremos llamar y haremos doble clic sobre la función deseada:

Ésta será insertada en la fórmula en curso. La sintaxis es la siguiente:

fun:IDENTIFICADOR_FUNCION@nombre_proyecto.ext([Parámetro1, Parámetro2, Parámetro3...])
dll:IDENTIFICADOR_LIBRERIA.IDENTIFICADOR_FUNCION@nombre_proyecto.ext([Parámetro1, Parámetro2, Parámetro3...])

Donde:

dll:: Prefijo que indica que se trata de una función de una librería externa.
IDENTIFICADOR_LIBRERIA: Mostrará el identificador de la librería externa.
IDENTIFICADOR_FUNCION: Mostrará el identificador de la función a llamar de la librería externa.
@: Indica que a continuación se declararán los datos del poyecto.
nombre_proyecto: Nombre del proyecto al que pertenece la librería.
.ext: Tipo de proyecto. .dat indica proyecto de datos y .app indica proyecto de aplicación.
([Parámetro1, Parámetro2, Parámetro3...]): Parámetros de la función, si los tiene. En caso de no tenerlos se incluirán solamente los paréntesis: ().

Ejemplo:

Si en la función se han declarado parámetros, éstos serán identificados al final de la misma entre paréntesis. En ese caso habrá que sustituir esos parámetros por los datos que queramos pasar a la función:

Si la función retonra algo, este retorno será atrapado en el objeto o sub-objeto desde el que sea llamada. Por ejemplo, si la llamada a la función la hacemos en un comando de instrucción de proceso Set, la variable inicializada en el mismo recogerá dicho retorno. Si la función la llamamos dentro del contenido inicial de un campo, el retorno de la función será el contenido que se le asigne al campo.