AGETS

Crea un diálogo para capturar uno o mas campos GET.

[ IF ] AGETS <aVal> ;
   [ PROMPT | PROMPTS <aTextos,...> ] ;
   [ TITLE <cTitulo> ] ;
   [ PICT | PICTURE | PICTURES <aPicture> ] ;
   [ SIZE | SIZES <aTamGet> ] ;
   [ WHEN | WHENS <abWhen> ] ;
   [ VALID | VALIDS <abValid> ] ;
   [ MSG | MSGS | MESSAGE | MESSAGES <aMensaje> ] ;
   [ ALIGN <aAlineado> ] ;
   [ FONT | FONTS <oLetra> ]

Descripción
Muestra un diálogo para realizar una captura sencilla de uno o mas campos, es la versión en comando de la función aGet().
IF Permite incluir el comando GET en un IF para validar si se presionó el botón aceptar (.t.), o se canceló la captura (.f.)
<aVal> Matriz con los valores de los campos que serán capturados, esta misma variable contendrá los valores resultado de la captura
<aTextos> Textos que se mostrarán para cada GET, si no se envían no aparecerá texto a la izquierda del GET, si lo que se envía no es una matriz, éste será el valor utilizado para el texto (SAY) del primer GET, si hay más GETs que textos, los ultimos GETs no tendrán texto
<cTitulo> Título del diálogo
<aPicture> Mascarillas (PICTURE) para cada GET, si no se envía no se usará mascarillas, si se envía una cadena de caracteres, se usará esa mascarilla para todos los campos, si se envía una matriz con menos elementos que GETs, los últimos GETs no tendrán mascarilla
<aTamGet> Ancho de cada GET, si no se envía tendrán el tamaño predefinido, si se envía un número, éste será el tamaño para todos los GETs, si se envía una matriz y es de un tamaño menor al número de GETs, los últimos GETs tendrán el tamaño predefinido
<abWhen> Codeblock utilizado para definir si se habilita o no (WHEN) cada GET, si no se envía siempre estarán activos todos los GETs, si se envía un codeblock será utilizado para todos los GETs, si se envía una matriz y es de un tamaño menor al número de GETs, los últimos GETs siempre estarán habilitados
<abValid> Validaciones (VALID) para cada GET, si no se envía todos los GETs aceptaran cualquier valor, si se envía un codeblock será utilizado para todos los GETs, si se envía una matriz y es de un tamaño menor al número de GETs, los últimos GETs aceptarán cualquier valor.
Este codeblock recibe los siguientes parámetros:
1 - El valor del GET evaluado
2 - aValores por referencia
3 - El numero del GET que fue validad
4 - El objeto del diálogo
<aMensaje> Texto que se muestra arriba de los GETs, si se envía un valor, éste será el mensaje mostrado, si se envía una matriz, cada elemento de la matriz se mostrará en una línea difrente, si no se envía no habrá mensaje.
<aAlineado> Alineación que tendrá cada línea de aMensaje, si se envía una matriz se indicará el alineado para cada renglón y si el tamaño de la matriz es menor al de aMensaje, los elementos que no alcancen alineación serán centrados, si no se envía, el mensaje se mostrará centrado. La alineación se indica con:
"C" - Centrado
"D" o "L" - Derecha
"I" o "R" -Izquierda
<oLetra> Objeto con el tipo de letra (font) que será usado para mostrar el mensaje de aMensajes, si no se envía se utilizará el tipo de letra predefinido.

Ejemplo

aValores := { space( 10 ), 0, date() }
IF AGETS aValores ;
      PROMPTS "Asignatura", "Participantes", "Fecha" ;
      VALIDS nil, { | nPart | nPart > 0 }
      MSG "Definición de grupos", "tercer periodo"
   msgInfo( "Datos capturados" )
ENDIF
wQOut( aValores )