LABEL [FORM FileName1 | FORM ?] [ENVIRONMENT] [Scope]
   [FOR lExpression1] [WHILE lExpression2] [NOOPTIMIZE]
   [RANGE nStartPage [, nEndPage]]
   [NOCONSOLE | OFF ] [SAMPLE] [PDSETUP]
   [NAME ObjectName]
   [OBJECT oReportListener | TYPE iExpression]
   [TO PRINTER [PROMPT] | TO FILE FileName2]
   [PREVIEW [PreviewDestination] [NOWAIT] [WINDOW WindowName]]

Параметры

[FORM FileName1 | FORM ?]

Определяет имя файла этикетки, или отображает диалоговый бокс Открытия для выбора существующего файла. По-умолчанию, расширением файла этикетки является (.lbx).

Примечание:
Если файл этикетки находится не в текущем каталоге, Вы должны указать полное имя файла (чтобы система смогла найти указанный файл).

Выполнение команды LABEL без параметров отображает диалоговый бокс Открытия файла.

[ENVIRONMENT]

Включена для совместимости с младшими версиями, для файлов этикеток версии ( 2.x). См. дополнительно  Управление данными в Отчетах 

Замечание:
Вы можете задать окружение данных, используя следующее свойство AutoOpenTables = True (.T.). Для закрытия, после получения отчета по этикетке, соответствующих таблиц задайте следующее: AutoCloseTables = True (.T.). См. дополнительно:  Свойство AutoOpenTables и Свойство AutoCloseTables.

[Scope]

Определяет интервал записей таблицы, для которых выполняется отчет по этикетке.  Возможные значения операнда scope: ALL, NEXT <nRecords>, RECORD <nRecordNumber>, и REST. По-умолчанию, для команды  LABEL считается значение ALL (все записи).

Примечание:
Если присутствует данный операнд Scope, то рассматривается диапазон записей таблицы, открытой в текущей рабочей области.

Для дополнитенльной информации см. раздел  Scope операнд.

[FOR lExpression1]

Определяет условие, согласно которому в отчет включаются только те записи, которые ему удовлетворяют. Данное условие определяет некоторый фильтр для обрабатываемых записей.  В данном случае условие фильтра lExpression1 может являться оптимизируемым по технологии Rushmore. Для лучшей производительности выполнения рассматриваемой команды используйте оптимизируемые выражения в операнде FOR. См. дополнительно:  Команда SET OPTIMIZE и Использование оптимизации запросов Rushmore для ускорения доступа к данным 

[WHILE lExpression2]

Определяет логическое условие при выполнении которого запись включается в отчет, т.е. пока lExpression2 = True (.T.).

[NOOPTIMIZE]

Отключает оптимизацию Rushmore выражения условия в команде LABEL.  См. дополнительно:  Команда SET OPTIMIZE и Использование оптимизации запросов Rushmore для ускорения доступа к данным 

[RANGE nStartPage [, nEndPage]]

Определяет диапазон страниц, выводимых на печать или другой устройство вывода. Параметр nStartPage определяет первую страницу печати, а параметр nEndPage определяет последнюю страницу печати. Если nEndPage отсутствует, то последней является  страница с номером =  32,767 (по умолчанию). Опция RANGE определяет диапазон выводимых страниц отчета, в отличие от опций scope, FOR, и WHILE, которые определяют диапазон обрабатываемых записей. Данный отбор страниц печати не работает в режиме предварительного просмотра "Print PreView"; однако при использовании "объектно-ориентированного"  режима с использованием опции OBJECT или команды SET REPORTBEHAVIOR 90 можно и при просмотре отчета выбирать соответствующие страницы. Для управления выбором необходимых страниц отчета в этом случае используются  элементы объекта ReportListener:  PrintPageCurrent, PrintRangeFrom, и PrintRangeTo . См. раздел Метод OnPreviewClose .

[NOCONSOLE | OFF]

Подавляет отображение выводимой информации на главном окне системы или активном пользовательском окне. Если Вы используете объектно-ориентированный режим получения отчета по команде LABEL, то выводимая информация не отображается на экране VFP, соответственно опции  NOCONSOLE и OFF не работают. Тем не менее, данные ключевые слова используются в объекте ReportListener.CommandClauses . Вам необходимо протестировать использование объета ReportListener, или соответствующего дочернего объекта на предмет отображения информации. См. дополнительно  Свойство CommandClauses .

[SAMPLE]

Для "символьно-ориентированных" Этикеток, созданных в системе FoxPro для MS-DOS, опция SAMPLE может быть использована для тестирования размещения Этикетки. Указатель записи не перемещается при использовании данной опции, При использовании опции SAMPLE, после распечатки текущей записи задается вопрос: Do you want more samples? (Еще просмотреть отчет?). При выборе <Yes> выполнение продолжится. Опция SAMPLE игнорируется для графических Этикеток, созданных в системе Visual FoxPro.

[PDSETUP]

Загружает драйвер принтера. Опция PDSETUP используется для "символьно-ориентированных" Этикеток, созданных в системе FoxPro для MS-DOS. Опция PDSETUP игнорируется для графических Этикеток, созданных в системе Visual FoxPro.

[NAME ObjectName]

Определяет имя переменной объекта для среды данных отчета Этикетка. Данный объект может иметь различные свойства иметоды, например,  AddObject, который может быть вызван при выполнении команды. Через данную переменную обеспечивается доступ к свойствам иметодам объекта Отчета. При отсутствии опции NAME, система Visual FoxPro использует (по-умолчнию) имя файла этикетки, которое может быть переопределено.

[OBJECT oReportListener | TYPE iExpression ]

Переключает систему Visual FoxPro в "объектно-ориентированный" режим обработки отчета Этикетка. В этом случае используется объект, построенный на базовом классе ReportListener ; Данная опция определяет также тип вывода информации. См. дополнительно:  Объект ReportListener , Свойство ListenerType , и Свойство OutputType  (Visual FoxPro). Опция OBJECT управляется для каждой команды LABEL в индивидуальном порядке, см. команду  SET REPORTBEHAVIOR , от установки которой зависит выполнение команды LABEL.

[TO PRINTER [PROMPT] | TO [FILE] FileName2 [[ADDITIVE] ASCII]

Отправляет результаты отчета на принтер, или в файл, заданный параметром FileName2, со стандартным расширением ( .txt). Опция  PROMPTотображает диалоговый бокс Печати, который запускается перед началом печати отчета. В объектро-ориентированнои режиме обработки отчетов данная опция включена в функциональность объекта ReportListener.CommandClauses.PrintPageCurrent . Если опция ASCII отсутствует, или применяется объектно-ориентированный режим,  то вывод обеспечивается функциональностью соответствующего объекта. Для вывода в текстовый файл формата ASCII необходимо использовать команду  SET REPORTBEHAVIOR 80 и включить данную опцию ASCII .

Примечание:
Опция ASCII может использоваться только на компьютере с установленным драйвером принтера. Без выполнения данного условия возникает ошибочная ситуация.

Файл формата ASCII содержит только текст. Другие элементы оформления отчета: шрифты, цветовое оформление, графические элементы (линии, прямоугольники) и прочее отсутствуют в текстовом файле ASCII. Опция ADDITIVE управляет ситуацией, когда необходимо добавить информацию в существующий файл или переписать его. Опции ADDITIVE и ASCII указываются именно в данном порядке в команде LABEL. 

[PREVIEW [PreviewDestination] [NOWAIT] [WINDOW WindowName]]

Отображает этикетку в окне предварительного просмотра Отчета. По-умолчанию, окно предварительного просмотра является модальным, что обеспечивает подключение соответствующего ToolBar-a Print Preview . Опция NOWAIT обеспечивает продолжение выполнения программы при получении отчета. 

Замечание:
"Символьно-ориентированные" отчеты, созданные в системе FoxPro MS-DOS имеют специальное окно просмотра. Данный механизм регулируется командой SET REPORTBEHAVIOR и не поддерживается в "объектно-ориентированных" отчетах, или режимах получения отчетов.

Если Вы включаете опцию WINDOW <WindowName>, тогда окно предварительного просмотра наследует характеристики указанного окна. Параметр WindowName должен указывать на значение свойства name некоторой формы, или определять переменную, использованную в команде DEFINE WINDOW. См. дополнительно:  Колманда DEFINE WINDOW . В следующей таблице описаны возможные значения параметра  PreviewDestination. Вы можете использовать опцию  WINDOW отдельно или в комбинации с различными значениями параметра PreviewDestination.

PreviewDestination	Описание
[IN WINDOW WindowName]	Определяет окно для размещения Предварительного просмотра Этикетки. Если включена опция IN WINDOW <WindowName>, то этикетка просматривается в данном окне WindowName.
IN SCREEN	Определяет, что предварительный просмотр размещается в главном окне системы Visual FoxPro, и не может быть перемещен за его пределы.

Этикетки создаются и редактируются командами  CREATE LABEL  или MODIFY LABEL .

Когда используется "объектно-ориентированный" режим вывода отчета все соответственные опции команды LABEL FORM представляются как элементы объекта ReportListener, за исключением опций диапазона обрабатываемых записей:  (scope, FOR, и WHILE). Вы можете использовать аттрибут CommandClauses.RecordTotal для определения количества обработанных Этикеток; или определить значения свойств объекта ReportListener перед выполнением печати отчета. Для дополнительной информации см. раздел:   Свойство CommandClauses  

Описание

Другие ссылки