根据表文件和标签定义文件打印标签。
语法
LABEL [FORM FileName1 | FORM ?]
[ENVIRONMENT]
[Scope]
[FOR lExpression1]
[WHILE lExpression2]
[NOCONSOLE]
[NOOPTIMIZE]
[PDSETUP]
[PREVIEW [NOWAIT]]
[SAMPLE]
[NAME ObjectName]
[TO PRINTER [PROMPT] | TO FILE FileName2]
参数
FORM FileName1
指定要打印的标签所对应的标签定义文件名。标签定义文件的默认扩展名为 .LBX。若标签定义文件不在当前驱动器或当前目录中,则必须指定驱动器和目录。
FORM ?
显示“打开”对话框,从中可以选择一个已有的标签文件。
ENVIRONMENT
包含此参数是为了提供与 FoxPro 2.x 标签的向后兼容性。若要恢复与 Visual FoxPro 标签相联系的数据环境,可把该数据环境的 AutoOpenTables 属性置为默认值“真”(.T.)。为了确保在标签打印完毕后关闭数据环境,可把该数据环境的 AutoClose 属性设置为默认值 “真” (.T.)。
当创建或修改标签时,可把当前的 Visual FoxPro 数据环境同标签定义文件一起保存起来。保存 Visual FoxPro 数据环境,可把所有打开的表和索引文件、索引顺序以及表之间的关系等其他信息作为附加记录放置在标签定义表中。
Scope
指定记录的范围。系统只打印该范围以内的记录。Scope 子句有 ALL,NEXT nRecords,RECORD nRecordNumber 和 REST 等。有关 Scope 子句的详细内容,请参阅作用域子句或语言概述。包含 Scope 参数的命令只对活动工作区中的表进行操作。
label 命令默认的范围是所有 (ALL) 记录。
FOR lExpression1
指定一个条件,只打印满足逻辑条件 lExpression1 的记录。这样可以把不想打印的记录筛选掉。
若 lExpression1 是一个可优化的表达式,则 Rushmore 将对 LABEL…FOR 命令所创建的查询进行优化。为了达到最好的运行效率,应在 FOR 子句中使用可优化的表达式。有关详细内容,请参阅
SET OPTIMIZE 和 深入了解 Rushmore 技术,或者《开发指南》第十七章“优化应用程序”。
WHILE lExpression2
指定一个条件,只要逻辑表达式 lExpression2 计算为“真”(.T.),就连续打印记录。
NOCONSOLE
在打印标签或向文件中传送标签时,不在 Visual FoxPro 主窗口或用户自定义窗口显示标签的输出结果。
NOOPTIMIZE
关闭 Rushmore 对 label 命令的优化。有关详细内容,请参阅 SET OPTIMIZE 和 深入了解 Rushmore 技术,或《开发指南》第十七章“优化应用程序”。
PDSETUP
加载打印机驱动程序设置。
在 Visual FoxPro,FoxPro for Windows 和 FoxPro for Macintosh 中,包含 PDSETUP 关键字,可以使用打印机驱动程序设置来打印在 FoxPro for MS-DOS 中创建的基于字符的标签。打印 Visual FoxPro 和 FoxPro for Macintosh 中建立的基于图形的标签时,忽略 PDSETUP。
在 FoxPro for MS-DOS 中,使用 FoxPro 标签设计器定义一个标签时,可以指定一个打印机驱动程序设置,它决定了标签打印的外观。如果环境与标签定义一起保存,则打印机驱动程序设置也被保存。如果打印标签时包含 PDSETUP
关键字,那么在打印时将装载并使用打印机驱动程序设置。
PREVIEW [NOWAIT]
打印之前先在“预览”窗口中显示标签,而不打印。若要打印标签,必须再发出一条不含 PREVIEW 子句的 LABEL
命令。
在 Visual FoxPro 中,若包含可选的 NOWAIT 子句,则在运行时 Visual FoxPro 将不等待关闭“页面预览”窗口,而是在该窗口打开的情况下继续往下执行。
SAMPLE
显示或打印一个样本来检验标签的对齐方式。在显示或打印完每个样本以后,提示“需要更多样本吗?”。选择“是”可以继续检验标签的对齐方式。
NAME ObjectName
为标签的数据环境指定一个对象变量名。数据环境和其中的对象具有属性和方法,例如 AddObject,运行时需要设置或调用它们。利用对象变量可对这些属性和方法进行访问。若不指定对象变量名,Visual FoxPro 将把标签文件的文件名作为对象变量名的默认值,供事件代码引用。
TO PRINTER [PROMPT]
向打印机发送标签。
在 Visual FoxPro,FoxPro for Windows 和 FoxPro for Macintosh 中,若包含可选项 PROMPT,则在开始打印以前提示“打印”对话框。
TO FILE FileName2
把 FoxPro for MS-DOS 中创建的基于字符的标签发送到文本文件 FileName2 中。包含 TO FILE 子句将创建该文件,默认扩展名为 .TXT。
说明
用 MODIFY LABEL 或 CREATE label 命令可以创建标签定义文件。
若不带任何参数发出 label 命令,“打开”对话框出现,显示已有的标签文件以供选择。