Команда REPORT

Выводит на дисплей или на печать отчет под управлением файла описания отчета, созданного по команде MODIFY REPORT или CREATE REPORT.

Синтаксис

REPORT FORM FileName1 | ?
[ENVIRONMENT]
[Scope] [FOR lExpression1] [WHILE lExpression2]
[HEADING cHeadingText]
[NOEJECT]
[NOCONSOLE]
[NOOPTIMIZE]
[PDSETUP]
[PLAIN]
[PREVIEW [NOWAIT]]
[TO PRINTER [PROMPT] | TO FILE FileName2[ASCII]]
[NAME ObjectName]
[SUMMARY]

Параметры

FORM FileName1

Задает имя файла описания отчета, по которому печатается отчет.

?

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

ENVIRONMENT

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

При работе с отчетами, преобразованными из ранних версий FoxPro, предложение ENVIRONMENT открывает и восстанавливает все таблицы и отношения среды данных, аже если свойство AutoOpenTables имеет значение "ложь" (.F.).

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

Scope

Задает диапазон записей, которые нужно включить в отчет. Включаются только записи, попадающие в указанный диапазон.

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

По умолчанию областью действия команды REPORT являются все записи предложение ALL.

FOR lExpression1

Печатает содержимое только тех записей, для которых выражение lExpression1 имеет значение "истина" (.T.). Предложение FOR позволяет отфильтровывать записи, которые не нужно печатать.

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

WHILE lExpression2

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

HEADING cHeadingText

Задает текст дополнительного заголовка, который нужно поместить на каждой стра ице отчета. Если вместе с предложением HEADING включено предложение PLAIN, п иоритет имеет предложение PLAIN.

NOEJECT

Допустимо только в FoxPro для MS-DOS.

Подавляет перевод страницы на принтере перед началом печати отчета.

NOCONSOLE

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

NOOPTIMIZE

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

PDSETUP

Допустимо только в FoxPro для MS-DOS.

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

PLAIN

Указывает, что страничный заголовок должен появляться только в начале отчета.

PREVIEW [NOWAIT]

Отображает отчет в режиме предварительного просмотра страницы, не передавая его на принтер. Чтобы напечатать отчет, нужно выдать команду REPORT с опцией TO PRINTER.

Следует заметить, что при включении предложения PREVIEW системные переменные памяти игнорируются.

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

Формируя дистрибутивный пакет приложения, проследите, чтобы в нем было доступ о меню View. Если панель инструментов Print Preview закрыта, ее нельзя будет восстановить без помощи меню View.

TO PRINTER [PROMPT]

Посылает отчет на принтер.

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

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

TO FILE FileName2[ASCII]

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

В Visual FoxPro можно включить необязательное предложение ASCII, что приведет к созданию текстового ASCII-файла из файла определения отчета. Если предложение ASCII опущено, коды PostScript и других принтеров записываются в текстовый фай . Вся графика, линии, прямоугольники и скругленные прямоугольники, имеющиеся в определении отчета, не войдут в текстовый ASCII-файл.

Число столбцов и строк на каждой странице текстового ASCII-файла определяется содержимым системных переменных памяти _ASCIICOLS и _ASCIIROWS. По умолчанию з ачениями _ASCIICOLS и _ASCIIROWS являются соответственно 80 столбцов и 63 ст оки. Эти значения соответствуют стандартной странице книжной ориентации.

NAME ObjectName

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

SUMMARY

Подавляет печать строк детализации. Печатаются только итоговые и промежуточные суммы.

Комментарии

По умолчанию имя файла описания отчета имеет расширение .FRX. Если этот файл е находится в каталоге, используемом по умолчанию, вместе с именем файла нужно указывать и путь к нему.