AXVISUAL()

Sintaxis

AxVisual( <cAlias>, <nReg>, <nOpc>, <aAcho>, <nColMens>, <cMensagem>, <cFunc>, <aButtons>, <lMaximized>)

Propósito

Permite que el usuario visualice las informaciones de un archivo de datos por medio de una interfaz, según la necesidad de la aplicación.

Argumentos

< cAlias >

Archivo de datos cuyas informaciones se podrán visualizar. 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 se podrá visualizar.

< nOpc >

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

< aAcho >

Array con el nombre de los campos que se mostrarán en la interfaz (pantalla). Los campos específicos del usuario siempre se mostrarán si no existe en el parámetro un elemento con la expresión “NOUSER”.

<nColMens >

Parámetro no utilizado.

< cMensagem >

Parámetro no utilizado.

< cFunc >

Función que cargará las variables que serán utilizadas por el objeto Enchoice. En este caso, el parámetro lVirtual está definido internamente por la función AxFunction() y se ejecuta como verdadera (.T.).

< aButtons >

Botones adicionales que se adicionarán en 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.

< 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 visualizar las informaciones incluidas anteriormente.

Ejemplos

AxVisual(cAlias,nReg,nOpc)