This chapter contains reference information for keywords, format modifiers and file creation using the Run_Report command.
Property | Description |
---|---|
Run_Report subroutine | Runs Report Builder reports. |
AVERAGE | The AVERAGE Run_Report keyword is used to generate the average of a numeric column and display it at the end of the report. |
BREAK-ON | Break-On causes Run_Report to put a physical break in the report as the value of a column changes. |
By and By-DSND | Sorts data within a Run_Report report. |
COLFONT | Use Colfont to set the font for a specific column in a report |
COLHDRFONT | Use COLHDRFONT to set the font for the entire header row. |
COLHEAD | Use COLHEAD to create an alternate column heading for a column. |
COLSHADE | This Run_Report keyword is used to set the percentage of shading on a column within the report. |
COLSIZE | Used to determine the width of a column within a Run_Report statement. |
COL-HDR-SUPP | COL-HDR-SUPP suppresses the column headings (column titles) that are automatically printed at the top of each page for each column being displayed. |
DBL-SPC | The modifier DBL-SPC causes a blank line to be printed between each row on the report. |
DET-SUPP | Used with Total and Average, DET-SUPP causes a value to be printed at the bottom of the report, and a subtotal or average to be printed at each control break. |
FONT | Use Font to set the default font for the body of the report. |
Footing | The Footing keyword will cause Run_Report to produce a running page footing (text at the bottom of each page). The footing can contain text, page numbers, dates, and other information. |
FTRFONT | Use FTRFONT to set the font for the report footer. |
Grand-Total | Grand-Total changes the text that accompanies the final total generated by the Total keyword within a Run_Report statement.. |
GRID | GRID will print gridlines between the columns and rows. |
Heading | The Heading keyword will cause the Run_Report command to produce a running page heading. The heading can contain text, page numbers, dates, and other information. |
HDRFONT | Use Hdrfont to set the font for the report heading. |
ID-SUPP | Run_Report will always print the key column in the leftmost column of the report. ID-SUPP causes this column not to be printed. |
JustLen | Use the keyword JustLen to override the justification or display length of a column as stored in the dictionary. You can override the justification or display length separately, or can combine the override specification in one command. |
LANDSCAPE | LANDSCAPE will print the report in landscape mode. |
LEGAL | LEGAL will print the report to legal sized paper dimensions. |
Limit | The Limit keyword restricts the output of data from a multi-valued column to those values that meet specified criteria. |
LPTR | The use of any of these keywords will send the report directly to the default printer. |
(M | Previews the report in a maximized preview window. |
MARGINS | Use MARGINS to specify the margin for pages within a report. |
NUMCOLUMNS | Use NUMCOLUMNS to repeat the selected columns of data within a report. |
OConv | Use the keyword OConv to specify a new or alternate output conversion (output format) for a column. |
(P | The use of any of these keywords will send the report directly to the default printer. |
PAPERSIZE | Use PAPERSIZE to print reports to a specific papersize. |
PORTRAIT | PORTRAIT will print the report in portrait mode. |
PRINTER | The use of any of these keywords will send the report directly to the default printer. |
SCREEN | SCREEN will send the report to the preview window. By default all Run_Report commands use this setting. |
T | The T keyword is used to print the total rows processed at the bottom of the report. |
Total | Total is used to generate the sum of a numeric column and display it at the end of a report generated through Run_Report. |
USING | The Using keyword causes the Run_Report to use a dictionary other than the dictionary of the table being listed or selected. |
Using Format Modifiers in Run_Report Statements | The various format modifier keywords can be inserted anywhere into a Run_Report statement (as long as they are not in the middle of a clause). |
File Creation Using Run_Report | The Run_Report facility allows for the creation of various file types, such as PDF, HTML and RTF. This is accomplished through the use of keywords in the Run_Report statement. |