LABEL FORM Display labels to the console ------------------------------------------------------------------------------ Syntax LABEL FORM <xcLabel> [TO PRINTER] [TO FILE <xcFile>] [NOCONSOLE] [<scope>] [WHILE <lCondition>] [FOR <lCondition>] [SAMPLE] Arguments <xcLabel> is the name of the label (.lbl) file that contains the FORM definition of the LABEL and can be specified either as a literal file name or as a character expression enclosed in parentheses. If an extension is not specified .lbl is assumed. TO PRINTER echoes output to the printer. TO FILE <xcFile> echoes output to <xcFile>. Specify <xcFile> as a literal file name or as a character expression enclosed in parentheses. If an extension is not specified, .txt is added. NOCONSOLE suppresses all LABEL FORM output to the console. If not specified, output automatically displays to the console unless SET CONSOLE is OFF. <scope> is the portion of the current database file to display labels. The default is ALL records. WHILE <lCondition> specifies the set of records meeting the condition from the current record until the condition fails. FOR <lCondition> specifies to LABEL FORM, the conditional set of records within the given scope. SAMPLE displays test labels as rows of asterisks. Each test label has the same number of columns and rows as the label definition. Then, following each test label display, is the query, "Do you want more samples?" Answering "Y" forces another test label display. Answering "N" causes LABEL FORM to display the actual labels for the specified scope and condition. Description LABEL FORM is a console command that sequentially accesses records in the current work area, displaying labels using a definition stored in a .lbl file. Create the .lbl using RL.EXE or by dBASE III PLUS. Refer to the "Report and Label Utility" chapter in the Programming and Utilities Guide for more information about creating label definitions. When invoked, output is sent to the screen and, optionally, to the printer and/or a file. To suppress output to the screen while printing or echoing output to a file, SET CONSOLE OFF before invocation of LABEL FORM or use the NOCONSOLE keyword. When invoked, LABEL FORM searches the current SET PATH drive and directory, if the <xcLabel> file is not found in the current directory and the path is not specified. Notes . Interrupting LABEL FORM: To interrupt a LABEL FORM, use INKEY() as a part of the FOR condition to test for an interrupt key press. See the example below. . Printer margin: LABEL FORM obeys the current SET MARGIN for output echoed to the printer. Examples . This example prints a set of labels and writes them to a file with a single command. Two forms of the command are shown: LOCAL cLabel := "Sales", cFile := "Sales" USE Sales INDEX Sales NEW LABEL FORM Sales TO PRINTER TO FILE Sales LABEL FORM (cLabel) TO PRINTER TO FILE (cFile) . This example interrupts LABEL FORM using INKEY() to test if the user pressed the Esc key: #define K_ESC 27 USE Sales INDEX Sales NEW LABEL FORM Sales WHILE INKEY() != K_ESC Files Library is CLIPPER.LIB.
See Also: REPORT FORM SET PRINTER