Share via

REPORT (Comando)

  • Artículo

Muestra o imprime un informe bajo el control de un archivo de definición de informe creado con MODIFY REPORT o CREATE REPORT.

REPORT FORM FileName1 | ? [ENVIRONMENT] [Scope] [FOR lExpression1]
   [WHILE lExpression2] [HEADING cHeadingText] [NOCONSOLE]
   [NOOPTIMIZE] [PLAIN] [RANGE nStartPage [, nEndPage]]
   [PREVIEW [[IN] WINDOW WindowName | IN SCREEN] [NOWAIT]]
   [TO PRINTER [PROMPT] | TO FILE FileName2 [ASCII]] [NAME ObjectName]
   [SUMMARY]

Parámetros

  • FileName1
    Especifica el nombre del archivo de definición de informe que se va a imprimir. En esta versión de Visual FoxPro también se notifica este parámetro al cuadro de diálogo Cola de impresión.

  • ?
    Muestra el cuadro de diálogo Abrir, en el que puede elegir un archivo de informe.

  • ENVIRONMENT
    Se incluye por compatibilidad con los informes de las versiones 2.x. Para restaurar el entorno de datos asociado a un informe de Visual FoxPro, establezca la propiedad AutoOpenTables del entorno de datos en el valor verdadero (.T.), que es el valor predeterminado. Para asegurarse de que el entorno del informe se cierra cuando se termina de imprimir el informe, establezca la propiedad AutoCloseTables del entorno de datos en el valor verdadero (.T.), que es también el valor predeterminado.

    En el caso de informes convertidos de versiones anteriores de FoxPro, la inclusión de ENVIRONMENT abrirá y restaurará todas las tablas y las relaciones en el entorno de datos, incluso si AutoOpenTables está establecida en falso (.F.).

    Al crear o modificar informes, puede guardar el entorno de datos actual de Visual FoxPro con el archivo de definición de informes. Esto coloca los registros adicionales en la tabla de definición de informe para todas las tablas abiertas y archivos de índice, para el orden de índice y para todas las relaciones entre las tablas.

  • Scope
    Especifica un alcance de registros para incluir en el informe. Solamente se incluyen en el informe los registros comprendidos dentro del rango.

    Las cláusulas de alcance son: ALL, NEXT nRecords, RECORD nRecordNumber y REST. Para obtener más información acerca de las cláusulas de alcance, vea los temas en pantalla Cláusulas de alcance e Introducción al lenguaje.

    El alcance predeterminado de REPORT es ALL (todos los registros).

  • FOR lExpression1
    Imprime solamente los datos incluidos en los registros en los que lExpression1 se evalúa como verdadero (.T.). La inclusión de FOR le permite filtrar los registros que no desea imprimir.

    Rushmore optimizará REPORT FOR si lExpression1 es una expresión optimizable. Para obtener el máximo rendimiento, utilice una expresión optimizable en la cláusula FOR.

    Para obtener más información vea SET OPTIMIZE y Utilizar Rushmore para agilizar el acceso a los datos.

  • WHILE lExpression2
    Especifica una condición por la cual los datos se imprimen mientras la expresión lógica lExpression2 se evalúe como verdadero (.T.).

  • HEADING cHeadingText
    Especifica texto para que se incluya un encabezado adicional en cada página del informe. Si se incluyen a la vez HEADING y PLAIN, la cláusula PLAIN tendrá preferencia.

  • NOCONSOLE
    Suprime el eco de un informe a la ventana principal de Visual FoxPro o a una ventana definida por el usuario cuando el informe se está imprimiendo o enviando a un archivo.

  • NOOPTIMIZE
    Para impedir la optimización Rushmore de REPORT, incluya NOOPTIMIZE.

    Si desea obtener más información, vea SET OPTIMIZE y Utilizar Rushmore para agilizar el acceso a los datos.

  • PLAIN
    Especifica que el encabezado de página aparece solamente al principio del informe.

  • RANGE nStartPage [, nEndPage]
    Especifica (excepto en la vista preliminar) el intervalo de páginas que se va a imprimir. nStartPage especifica la primera página que se va a imprimir; nEndPage especifica la última página que se va a imprimir. Si se omite nEndPage, el número de la última impresa será el predeterminado: 65.534.

  • PREVIEW [[IN] WINDOW WindowName | IN SCREEN]
    Muestra el informe en el modo de Vista previa en lugar de enviarlo a la impresora. Para imprimir un informe, es necesario ejecutar REPORT con TO PRINTER.

    Tenga en cuenta que las variables del sistema se pasan por alto cuando se incluye PREVIEW.

    Para especificar la ventana para la vista previa del informe, incluya la cláusula opcional WINDOW o IN WINDOW. WindowName puede ser el nombre de una ventana creada con DEFINE WINDOW. Si incluye la cláusula WINDOW, en la vista previa se utilizarán las características (título, tamaño, etc.) de la ventana que especifique en WindowName. Si incluye la cláusula IN WINDOW, se obtiene una vista previa del informe en la ventana especificada en WindowName.

    Puede incluir la cláusula opcional IN SCREEN para especificar que la ventana de vista previa del informe esté contenida en la ventana principal de Visual FoxPro y no se pueda mover fuera de ella.

    Puede incluir la cláusula opcional NOWAIT de modo que en tiempo de ejecución Visual FoxPro no espere a que se cierre la ventana Vista previa antes de continuar con la ejecución del programa. En lugar de esto, Visual FoxPro continuará la ejecución del programa mientras esté abierta la ventana de vista previa de la página.

    En una aplicación distribuida, asegúrese de que el menú Ver está disponible. Si se cierra la barra de herramientas de Vista previa, no podrá restaurarse a menos que esté disponible el menú Ver.

  • TO PRINTER [PROMPT]
    Envía un informe a la impresora.

    En Visual FoxPro, puede incluir la cláusula opcional PROMPT para mostrar un cuadro de diálogo de configuración de la impresora antes de que comience la impresión. Las opciones de configuración de la impresora que puede ajustar dependen del controlador de impresora que tenga instalado actualmente. Coloque PROMPT justo después de TO PRINTER.

  • TO FILE FileName2 [ASCII]
    Especifica el archivo de texto al que se envía un informe. Se utiliza el controlador de impresora actual cuando se envía el informe al archivo de texto. El archivo creado cuando incluye TO FILE tiene la extensión predeterminada .txt.

    Puede incluir la cláusula opcional ASCII para crear un archivo de texto ASCII a partir del archivo de definición de informe. Sin la cláusula ASCII, se escriben códigos PostScript y otros códigos de impresora al archivo de texto. Los gráficos, líneas, rectángulos o rectángulos redondeados de la definición del informe no aparecen en el archivo de texto ASCII.

    El número de columnas y filas de cada página del archivo de texto ASCII está determinado por el contenido de las variables del sistema _ASCIICOLS y _ASCIIROWS. Los valores predeterminados para _ASCIICOLS y _ASCIIROWS son 80 columnas y 63 filas, respectivamente. Estos valores corresponden a la página vertical estándar.

  • NAME ObjectName
    Especifica un nombre de variable de objeto para el entorno de datos de un informe. El entorno de datos y los objetos del entorno de datos tienen propiedades y métodos, como AddObject, que necesitan establecerse o llamarse en tiempo de ejecución. La variable de objeto ofrece acceso a estas propiedades y métodos. Si no especifica NAME, Visual FoxPro usará de forma predeterminada el nombre del archivo de informe al que se puede hacer referencia en el código asociado a los eventos.

  • SUMMARY
    Suprime la impresión de las líneas de detalle. Solamente se imprimen los totales y subtotales.

Observaciones

La extensión predeterminada de un archivo de definición de informe es .frx. Si el archivo de definición de informe está en una unidad distinta de la unidad o el directorio predeterminados, deberá incluir también la ruta de acceso con el nombre del archivo.

Vea también

_ASCIICOLS | _ASCIIROWS | CREATE REPORT | DataEnvironment (Objeto) | MODIFY REPORT