/*
 * $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 Grate <alex_degarate@hotmail.com>
 * Documentacin en Espaol de:
 *      REPORT FORM
 *
 * Copyright 1999 Luiz Rafael Culik <culik@sl.conex.net>
 *    Documentacion
 *
 * Vea doc/license.txt por los trminos 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>         Expresin lgica de una Condicin WHILE
 *
 *      <bFor>           Expresin lgica de una Condicin FOR
 *
 *      <cEncabezado>    Encabezado del Reporte
 *  $RETURNS$
 *      NIL
 *  $DESCRIPTION$
 *      Este comando imprime un informe  reporte llamado <cNombreReporte>,
 *      el cual es un archivo estandar FRM. La extensin del archivo no es
 *      necesaria porque la extensin .frm es asumida por defecto.
 *      Los comandos SET PATH TO y SET DEFAULT TO afectan la bsqueda 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 clusula
 *      TO PRINTER,  bien a un archivo usando la clusula TO FILE.
 *
 *      Si la clusula TO FILE es especificada, el nombre de un archivo
 *      alterno es especificado en <cArchivo>.
 *      Si ninguna extensin de archivo es especificada, la extensin .txt
 *      es agregada.
 *
 *      <cAlcance> es la condicin de alcance para este comando. Alcances
 *      vlidos incluyen:
 *      NEXT <expN> (nmero de registros a ser visualizados donde <expN>
 *            es el nmero de registros)
 *      RECORD <expN> (un registro especfico a ser impreso)
 *      REST  (todos los registros comenzando desde la posicin del registro
 *            actual.
 *      ALL (todos los registros)
 *      Por defecto es ALL (todo).
 *
 *      Ambas expresiones lgicas pueden trabajar en conjuncin con la otra
 *      Donde <bFor> es la expresin lgica para la condicin FOR (para
 *      registros a ser visualizados dentro de un rango dado).
 *      <bWhile> es la expresin lgica para la condicin WHILE (para los
 *      registros a ser visualizados hasta que se deje de cumplir la
 *      condicin.
 *
 *      Si la clusula PLAIN es especificada, la fecha y los nmeros de
 *      pagina son suprimidos. En adicion no hay salto automtico de pgina
 *      y el ttulo del reporte y los encabezados de columna aparecen una
 *      sola vez al principio del reporte.
 *
 *      Si la clusula HEADING es usada, <cEncabezado> es visualizado en el
 *      ttulo de cada pgina del reporte. El valor de <cEncabezado> es
 *      evaluado solamente una vez antes de la ejecucin del reporte; variar
 *      los valores de <cEncabezado> no est permitido.  La clusula PLAIN
 *      tiene precedencia sobre la clusula HEADING si ambas son incluidas.
 *
 *      Si la clusula NOEJECT es usada, la eyeccin de la pgina inicial
 *      en el reporte no ser realizado cuando la clusula TO PRINTER sea
 *      especificada.
 *      De otro modo esta clusula no tendr efecto.
 *
 *      Si la clusula SUMMARY es especificada, el reporte contendr
 *      solamente grupos, subgrupos e informacin de totales. La informacin
 *      detallada del elemento ttulo ser ignorada.
 *
 *      Si la clusula 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 librera es rtl
 *  $SEEALSO$
 *      LABEL FORM
 *  $END$
 */


