Click above to get retro games delivered to your door ever month!

Syntax

LIST_EM( cReportnam, cTarget, acHdr_styl, ;
         acItm_styl[, bcHdr_udf ], xcItm_udf, ;
         [, bcSumm_udf, [, nWidth [, nIndexord ;
         [, cOutfile [, pFirstkey ;
         [, xcCondition[, xcStop ]]]]] )

Purpose

An interface for line-oriented, hard-coded reports. To use it, write
xcItem_udf, and optionally xcHdr_udf and xcSumm_udf.

Arguments

     cReportnam -- Name of the report (to appear on the header)

     cTarget -- S, F, or P to specify output destination of
                    screen, file, or printer, respectively; defaults to a
                    call to SET_TARGET() to select destination
                    interactively

     acHdr_styl -- Printer code name, or array of them, to set up print
                       style for header

     acItm_styl -- Printer code name, or array of them, to set up print
                       style of report items

     bcHdr_udf -- a code block or the name of the udf which displays
                      the report header; defaults to RPT_HEADR()

     xcItm_udf -- a code block or the name of the udf which displays a
                      real or virtual record.

     bcSumm_udf -- a code block or the name of the udf which prints the
                       summary; defaults to printing a simple graphic line

     nWidth -- if passed, width of the report; defaults to MAXCOL()

     nIndexord -- if passed, index order number to use for the report,
                      otherwise the current index order is used.

     cOutfile -- if passed, the name of the output file file; defaults
                     to the first 8 characters of the report name

     pPirstkey -- if passed, key value for starting record of report.
                      SOFTSEEK is set ON for this SEEK.

     xcCondition -- if passed, expression which macro-evaluates to .T.
                        or .F. for each record encountered, determining
                        whether that record is to be included in the
                        report, defaults to entire file

     xcStop -- if passed, an expression which macro-evaluates to .T.
                   where record-processing should stop; defaults to
                   processing until the EOF() is reached.

Setup

PRINTER table must be open, indexed on Type_style.

Example

See report functions in the example program AAI_RPTS.PRG.

Returns

.T.

Side Effects

Crash on bad data or setup.

Artful Calls

PUSH/POP_SCR, MIDDLE, SET_TARGET, LINEOUT, STAT_LINE, GET_FILTER,
AEMPTY

Source File

AA_LISTM.PRG