Команда 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 по технологии Rushmore. Подробнее см. описание команды 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 со списком имеющихся файлов этикеток, из которых можно выбрать нужный.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 12.02.2003