AXDELETA()

Sintaxis

AxDeleta( <cAlias>, <nReg>, <nOpc>, <cTransact>, <aCpos>, <aButtons>, <aParam>, <aAuto>, <lMaximized>)

Propósito

Permite que el usuario modifique las informaciones de un archivo de datos por medio de una interfaz, de acuerdo con la necesidad de la aplicación.

Argumentos

< cAlias >

Archivo de datos cuyas informaciones se borrarán. Este archivo está registrado en el diccionario de tablas del Protheus (SX2).

< nReg >

Número del registro (recno) posicionado en el alias activo y que también se borrará.

< nOpc >

Número de la linea del array aRotina que define el tipo de edición (Inclusión, Modificación, Borrado y Visualización). La función AxDeleta() se ejecutará cuando el usuario seleccione la opción Borrar.

< cTransact >

Función que se ejecutará dentro de la transacción de la AxFunction().

< aCpos >

Array con el nombre de los campos que aparecerán en la pantalla.

< aButtons >

Botones adicionales que se adicionarán a la barra de herramientas estándar (EnchoiceBar). Las informaciones de cada botón se deben pasar en el siguiente formato:

aArray[n][1]  -->  Imagen del botón

aArray[n][2]  -->  Bloque de código que contiene la acción que el botón ejecutará.

aArray[n][3]  -->  Título del botón.

< aParam >

Funciones que se ejecutarán en puntos de la AxFunction() definidos previamente, según la siguiente descripción:

aParam[1]  -->  Bloque de código que se procesará antes de mostrar las informaciones en la pantalla.

aParam[2]  -->  Bloque de código para procesar en la validación de la confirmación del borrado.

aParam[3]  -->  Bloque de código que se ejecutará dentro de la transacción de la AxFunction().

aParam[4]  -->  Bloque de código que se ejecutará fuera de la transacción de la AxFunction().

< aAuto >

Indica que la propia función hará la modificación automáticamente, sin la necesidad de mostrar la pantalla de interfaz y con base en los datos enviados en este parámetro.

Este array se monta en el formato utilizado por la función estándar MsExecAuto(). Si se informa este array, se mostrará la pantalla de interfaz y se ejecutará la función EnchAuto().

El array se debe montar en el siguiente formato:

aAuto[n][1]  -->  Nombre del campo.

aAuto[n][2]  -->  Contenido del campo.

aAuto[n][3]  -->  Validación que se utilizará en sustitución a las validaciones definidas en el diccionario de datos SX3.

< lMaximized >

Indica si la ventana se maximizará o no.

Se debe informar verdadero (.T.) para maximizar la ventana o falso (.F.) para no maximizarla.

Utilización

Este componente visual es muy utilizado en la interfaz de las aplicaciones para borrar informaciones existentes en los archivos de datos.

Ejemplos

USER FUNCTION CTJ40Exc()

LOCAL nReg := ( cString )->( Recno() )

AxDeleta(cString, nReg, 5)

RETURN NIL