Команда LABEL

Печатает этикетки из файла таблицы или из файла описания этикетки.

Синтаксис

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 ?

Отображает диалоговое окно Open, в котором можно выбрать существующий файл тикетки.

ENVIRONMENT

Включено для совместимости с этикетками версий 2.x. Чтобы восстановить среду анных, связанную с этикеткой Visual FoxPro, задайте значение свойства AutoOpenTables этой среды данных равным "истине" (.T.), которое принимается по умолча ию. Чтобы гарантировать закрытие среды этикетки по завершении печати этикетки, установите для свойства AutoCloseTables среды данных значение "истина" (.T.), которое также принимается по умолчанию.

Когда вы создаете или модифицируете этикетки, вы можете сохранить текущую сре у данных Visual FoxPro вместе с файлом определения этикетки. При сохранении сре ы данных Visual FoxPro в таблицу определения этикетки включаются дополнительн е записи, описывающие все открытые файлы таблиц и индексов, порядок индексов и все отношения между таблицами.

Scope

Задает диапазон записей. Печатаются только записи, попадающие в данный диапазо . Он определяется следующими предложениями: ALL, NEXT nRecords, RECORD nRecordNumber и REST. Подробнее предложения диапазона см. тему Предложения диапазона или главу 2 "Обзор языка программирования" Руководства разработчика. Команды, использующие параметр Scope, воздействуют только на таблицу активной рабочей области.

По умолчанию диапазоном для команды LABEL является ALL все записи.

FOR lExpression1

Задает условие, в соответствии с которым печатаются только записи, удовлетво яющие логическому выражению lExpression1. Это позволяет отфильтровывать ненужные записи.

Технология Rushmore оптимизирует запрос, формируемый командой LABEL ... FOR, если lExpression1 является оптимизируемым выражением. В целях повышения производительности екомендуется в предложении FOR использовать оптимизируемое выражение. Подробнее об этом см. описание команды SET OPTIMIZE и Основы технологии Rushmore или главу 17 "Оптимизация приложений" Руководства разработчика.

WHILE lExpression2

Задает условие, согласно которому записи печатаются, пока логическое выражение lExpression2 остается истинным (.T.).

NOCONSOLE

Подавляет отображение вывода этикеток в основное окно Visual FoxPro или в ок о, определенное пользователем, когда идет печать этикеток или передача их в файл.

NOOPTIMIZE

Запрещает оптимизацию команды LABEL по технологии Рашмора. Подробнее см. описа ие команды SET OPTIMIZE и Основы технологии Rushmore или главу 17 "Оптимизация приложений" Руководства разработчика.

PDSETUP

Загружает установки драйвера принтера.

В Visual FoxPro, FoxPro для Windows и FoxPro для Macintosh можно, задав PDSETUP, использовать параметры драйвера принтера для печати этикеток, созданных в символьном режиме в FoxPro для MS-DOS. PDSETUP игнорируется, когда печатаются тикетки, созданные в графическом режиме в Visual FoxPro или FoxPro для Macintosh.

В FoxPro для MS-DOS, создавая определение метки с помощью конструктора тикеток FoxPro, можно задать параметры драйвера принтера, которые будут определять печатный вид этикеток. Если вместе с определением этикетки сохранить среду выпол ения, будут сохранены и параметры драйвера принтера. Если при печати этикеток задать ключевое слово PDSETUP, будут загружены параметры драйвера принтера, испо ьзуемые в процессе печати этикеток.

PREVIEW

Отображает этикетки в окне предварительного просмотра перед печатью, но не печатает их. Чтобы напечатать этикетки, нужно выдать команду LABEL еще раз без пре ложения PREVIEW.

В Visual FoxPro можно включить необязательное предложение NOWAIT, чтобы на тапе выполнения не нужно было для продолжения работы программы ожидать закрытия окна предварительного просмотра страниц. В этом случае Visual FoxPro продолжит в полнение программы с открытым окном предварительного просмотра страниц.

SAMPLE

Отображает или печатает образец для проверки выравнивания этикеток. После каж ого вывода образца этикетки на экран или на печать появляется приглашение "Do you want more samples?" [Повторить вывод образца?]. Если вам нужно еще раз прове ить выравнивание этикетки, нажмите кнопку Yes.

NAME ObjectName

Задает имя переменной объекта для среды данных этикетки. Среда данных и вхо ящие в нее объекты обладают свойствами и методами, например AddObject, которые еобходимо устанавливать или вызывать на этапе выполнения. Переменная объекта о еспечивает доступ к этим свойствам и методам. Если вы не задали предложение NAME, Visual FoxPro использует по умолчанию имя файла этикетки, на который можно сс латься в коде, соответствующем событиям.

TO PRINTER [PROMPT]

Посылает этикетку на принтер.

В Visual FoxPro, FoxPro для Windows и FoxPro для Macintosh можно задать нео язательное предложение PROMPT, в результате чего перед началом печати на экране появится диалоговое окно Print.

В FoxPro для MS-DOS предложение PROMPT игнорируется.

TO FILE FileName2

Посылает этикетки, созданные в символьном режиме в FoxPro для MS-DOS, в текстовый файл FileName2. Файл, создаваемый при включении предложения TO FILE, по умолчанию имеет асширение имени .TXT.

Комментарии

Файлы описания этикеток создаются командой MODIFY LABEL или CREATE LABEL.

Если выдать команду LABEL без аргументов, появится диалоговое окно Open со списком имеющихся файлов этикеток, из которых можно выбрать нужный.