Команда DISPLAY

Отображает информацию о текущей таблице в основном окне Visual FoxPro или в по ьзовательском окне.

Синтаксис

DISPLAY
[[FIELDS] FieldList]
[Scope] [FOR lExpression1] [WHILE lExpression2]
[OFF]
[NOCONSOLE]
[NOOPTIMIZE]
[TO PRINTER [PROMPT] | TO FILE FileName]

Параметры

FIELDS FieldList

Задает поля, которые следует отобразить. Если предложение FIELDS FieldList опущено, по умолчанию отображаются все поля таблицы.

Содержимое memo-полей, явно не включенных в список, не отображается. Ширина показываемых memo-полей определяется установкой SET MEMOWIDTH.

Scope

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

По умолчанию областью действия команды DISPLAY является одна текущая запись (п едложение NEXT 1).

FOR lExpression1

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

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

WHILE lExpression2

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

OFF

Отменяет отображение номеров записей. Если опустить OFF, перед каждой записью удет ставиться ее номер.

NOCONSOLE

Подавляет вывод в основное окно Visual FoxPro или в активное пользовательское окно.

NOOPTIMIZE

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

TO PRINTER [PROMPT]

Направляет вывод команды DISPLAY на принтер.

В Visual FoxPro, FoxPro для Windows и FoxPro для Macintosh можно задать нео язательное предложение PROMPT, по которому перед началом печати отображается специальное диалоговое окно. В этом диалоговом окне можно изменить установки принте а, включая число копий и номера печатаемых страниц. Набор параметров принтера, допускающих регулирование, определяется установленным в данный момент драйве ом принтера. Ключевое слово PROMPT нужно указывать сразу после TO PRINTER.

В FoxPro для MS-DOS ключевое слово PROMPT игнорируется.

TO FILE FileName

Направляет вывод команды DISPLAY в файл FileName. Если такой файл уже существует и установка SET SAFETY имеет значение ON, бу ет выдан запрос на подтверждение записи поверх файла.

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

Комментарии

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

Команду DISPLAY можно также использовать для отображения результатов выраже ий, которые могут включать литералы, переменные памяти, элементы массива, поля и memo-поля в различных сочетаниях. Имена полей и выражения отображаются в том с учае, если действует установка SET HEADINGS ON.