/*
 * $Id: treport.txt 9312 2008-09-05 00:08:34Z vszakats $
 */

/*
 * Las siguientes partes son derechos adquiridos de sus autores individuales.
 * www - http://www.harbour-project.org
 *
 * Copyright 2002 Alejandro de G rate <alex_degarate@hotmail.com>
 * Documentaci¢n en Espa¤ol de:
 *      REPORT FORM
 *
 * Copyright 1999 Luiz Rafael Culik <culik@sl.conex.net>
 *    Documentacion
 *
 * Vea doc/license.txt por los t‚rminos de la licencia.
 *
 */

/*  $DOC$
 *  $FUNCNAME$
 *      REPORT FORM
 *  $CATEGORY$
 *      Comando
 *  $ONELINER$
 *      Visualiza un reporte
 *  $SYNTAX$
 *      REPORT FORM <cNombreReporte> [TO PRINTER] [TO FILE <cArchivo>]
 *                  [<cAlcance>]  [WHILE <bWhile> ] [FOR <bFor> ]
 *                  [PLAIN |HEADING <cEncabezado>] [NOEJECT] [SUMMARY]
 *                  [NOCONSOLE]
 *  $ARGUMENTS$
 *      <cNombreReporte> Nombre del archivo de reporte
 *
 *      <cArchivo>       Nombre de un archivo alterno
 *
 *      <cAlcance>       Ambito ¢ alcance
 *
 *      <bWhile>         Expresi¢n l¢gica de una Condici¢n WHILE
 *
 *      <bFor>           Expresi¢n l¢gica de una Condici¢n FOR
 *
 *      <cEncabezado>    Encabezado del Reporte
 *  $RETURNS$
 *      NIL
 *  $DESCRIPTION$
 *      Este comando imprime un informe ¢ reporte llamado <cNombreReporte>,
 *      el cual es un archivo estandar FRM. La extensi¢n del archivo no es
 *      necesaria porque la extensi¢n .frm es asumida por defecto.
 *      Los comandos SET PATH TO y SET DEFAULT TO afectan la b£squeda del
 *      archivo <cNombreReporte>; a menos que la unidad de disco y el path
 *      sean especificados en <cNombreReporte>, REPORT buscar  dentro del
 *      path especificado en el comando SET PATH y si no puede encontrar
 *      el modelo de reporte en el directorio actual.
 *
 *      La salida del reporte ser  desplazada basada en el valor de
 *      SET MARGIN TO.
 *
 *      Por defecto la salida ir  a la pantalla, sin embargo esta salida
 *      puede ser redirigida ¢ bien a la impresora usando la cl usula
 *      TO PRINTER, ¢ bien a un archivo usando la cl usula TO FILE.
 *
 *      Si la cl usula TO FILE es especificada, el nombre de un archivo
 *      alterno es especificado en <cArchivo>.
 *      Si ninguna extensi¢n de archivo es especificada, la extensi¢n .txt
 *      es agregada.
 *
 *      <cAlcance> es la condici¢n de alcance para este comando. Alcances
 *      v lidos incluyen:
 *      NEXT <expN> (n£mero de registros a ser visualizados donde <expN>
 *            es el n£mero de registros)
 *      RECORD <expN> (un registro espec¡fico a ser impreso)
 *      REST  (todos los registros comenzando desde la posici¢n del registro
 *            actual.
 *      ALL (todos los registros)
 *      Por defecto es ALL (todo).
 *
 *      Ambas expresiones l¢gicas pueden trabajar en conjunci¢n con la otra
 *      Donde <bFor> es la expresi¢n l¢gica para la condici¢n FOR (para
 *      registros a ser visualizados dentro de un rango dado).
 *      <bWhile> es la expresi¢n l¢gica para la condici¢n WHILE (para los
 *      registros a ser visualizados hasta que se deje de cumplir la
 *      condici¢n.
 *
 *      Si la cl usula PLAIN es especificada, la fecha y los n£meros de
 *      pagina son suprimidos. En adicion no hay salto autom tico de p gina
 *      y el t¡tulo del reporte y los encabezados de columna aparecen una
 *      sola vez al principio del reporte.
 *
 *      Si la cl usula HEADING es usada, <cEncabezado> es visualizado en el
 *      t¡tulo de cada p gina del reporte. El valor de <cEncabezado> es
 *      evaluado solamente una vez antes de la ejecuci¢n del reporte; variar
 *      los valores de <cEncabezado> no est  permitido.  La cl usula PLAIN
 *      tiene precedencia sobre la cl usula HEADING si ambas son incluidas.
 *
 *      Si la cl usula NOEJECT es usada, la eyecci¢n de la p gina inicial
 *      en el reporte no ser  realizado cuando la cl usula TO PRINTER sea
 *      especificada.
 *      De otro modo esta cl usula no tendr  efecto.
 *
 *      Si la cl usula SUMMARY es especificada, el reporte contendr 
 *      solamente grupos, subgrupos e informaci¢n de totales. La informaci¢n
 *      detallada del elemento t¡tulo ser  ignorada.
 *
 *      Si la cl usula NOCONSOLE es especificada, la salida a la consola ser
 *      desactivada mientras este comando este siendo ejecutado.
 *  $EXAMPLES$
 *      FUNCTION() MAIN
 *        USE Test New
 *        Report FORM EE
 *        USE
 *      RETURN NIL
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      Este comando es totalmente compatible con CA-Cl*pper.
 *  $PLATFORMS$
 *      Todas
 *  $FILES$
 *      La librer­a es rtl
 *  $SEEALSO$
 *      LABEL FORM
 *  $END$
 */


