метка REPORT[APPEND][DEVICE()][LENGTH()][LINE()][PAGE()]
[PRE()][PRINTER()][WIDTH()]
[метка] [HEADER[ALLOW()][FIXED][PRE()][SEPARATE()]
[ROW()]
[COL()]
[SUPPRESS()]
[метка] [STRING()]
[метка] [TEXT()]
[метка] [CONTROL()]
.]
[метка] [DETAIL[ALLOW()][ALONE][FIXED][PRE()][SEPARATE()]
[ROW()]
[COL()]
[SUPPRESS()]
[метка] [STRING()]
[метка] [TEXT()]
[метка] [CONTROL()]
.]
[метка] [FOOTER[ALLOW()][FIXED][PRE()][SEPARATE()]
[ROW()]
[COL()]
[SUPPRESS()]
[метка] [STRING()]
[метка] [TEXT()]
[метка] [CONTROL()]
.]
.
| APPEND | Дописать отчет в конец файла. |
| DEVICE | Устройство для вывода отчета. |
| LENGTH | Максимальное число строк на странице. |
| LINE | Переменная - счетчик строк. |
| PAGE | Переменная - счетчик страниц. |
| PRE | Префикс отчета или элемента отчета. |
| PRINTER | Название принтера из файла описаний принтеров. |
| WIDTH | Максимальная длина строки. |
| HEADER | Заголовок страницы. |
| DETAIL | Тело отчета. |
| FOOTER | Подножие страницы. |
| ALLOW | Задает минимальное число строк, которое надо пропустить после печати данного элемента отчета. |
| ALONE | Описывает отчет без заголовков или подножий. |
| FIXED | Описывает структуру фиксированной длины. |
| SEPARATE | Задает число пустых строк между элементами отчета. |
| ROW | Задает строку. |
| COL | Задает столбец. |
| SUPPRESS | Подавляет печать пустого элемента. |
| STRING | Переменная или символьная константа. |
| TEXT | Многострочное символьное поле. |
| CONTROL | Управляющий код принтера. |
Оператор REPORT задает начало структуры-отчета. HEADER, DETAIL и FOOTER это подструктуры, из которых формируется отчет. Отчет должен быть явно открыт оператором OPEN. Элементы открытого отчета можно выводить на печать (1) оператором PRINT. При переполнении страницы могут автоматически печататься структуры HEADER и FOOTER. Поскольку этот документ - руководство по языку, то все атрибуты и операторы, связанные с отчетами, мы рассмотрим ниже более подробно. Обычно, отчеты Кларион "рисуются" с помощью средств форматирования РЕДАКТОРА ТЕКСТОВ и ГЕНЕРАТОРА ПРИЛОЖЕНИЙ с гарантированно правильным синтаксисом. При этом становится необязательным ручное создание структур отчетов. (2)
(А.С.П.
(1) - Под выводом на печать подразумевается не только вывод на
принтер, но и на любое устройство, пригодное для вывода
сформированного отчета, например файл или экран.
(2) - На данный момент (19.05.94) у меня есть версия Clarion Da- taBase Developer 3.007.105, в которой "ручное создание" отчетов, а точнее правка того, что в них наворотил ДИЗАЙ- НЕР, далеко не необязательна!)
Пример:
CustRpt REPORT !Отчет по покупателям
!описания элементов отчета
. !Конец описания отчета
APPEND
APPEND работает вместе с атрибутом DEVICE. Если в качестве устройства для печати задано имя файла, то параметр APPEND не позволит стереть существующий файл, отчет будет дописан в конец файла.
Пример:
Report REPORT,DEVICE('MYFILE.RPT'),APPEND
!Печать дописыванием в конец фай-
! ла.
!описания элементов отчета
.
DEVICE(имя)
| имя | Строковая константа, переменная или выражение задающее устройство или имя файла. |
Атрибут отчета DEVICE задает устройство, на которое будет выводиться отчет. Если ИМЯ не является именем стандартного устройством DOS, подразумевается, что это имя файла. Если ИМЯ, это имя файла, то файл создается на указанном диске в указанном каталоге. Если диск и/или каталог не заданы, то файл создается в текущем каталоге текущего диска. Если заданный файл уже существует, то он будет замещен новым, если отчет не будет иметь атрибута APPEND. Если спецификация файла некорректна, то DEVICE игнорируется и отчет печатается на LPT1. Если ИМЯ - CON, то отчет будет выводиться на экран, начиная с текущей позиции курсора. Можно использовать SETCURSOR для установки курсора перед его выводом на экран. Отчеты могут быть выведены на следующие стандартные устройства ДОС:
CON Консоль
PRN Первый параллельный порт
LPT1 Первый параллельный порт
LPT2 Второй --/-- --/--
LPT3 Третий --/-- --/--
AUX Первый последовательный порт
COM1 Первый последовательный порт
COM2 Второй последовательный порт
NUL Пустое устройство
Пример:
Report REPORT,DEVICE('LPT2') !Отчет - на второй принтер
Report1 REPORT,DEVICE('C:\REPORTS\CUSTLST.RPT')!Отчет - в файл
Report2 REPORT,DEVICE(DeviceName)!Имя устройства хранится в пе-
! ременной DEVICENAME
См. также: SETCURSOR
LENGTH (число строк на странице)
LENGTH(value)
| value | Целочисленная константа или переменная. |
Атрибут LENGTH задает максимальное число строк на странице. Автоматический переход на новую страницу происходит на основании значения VALUE. Если VALUE=0, то отслеживание переполнения страницы выключается. VALUE минус число_строк_для_HEADER_и_FOOTER будет числом строк, доступным для печати DETAIL-структур.
Некоторые принтеры сами отслеживают длину страницы. Если VALUE больше или равно внутренней длине страницы принтера, то может произойти неожиданный перевод формата.
Пример:
CustRpt REPORT,LENGTH(60) !В отчете 60 строк на странице
!описания элементов отчета
. !Конец описаний отчета
CustRpt2 REPORT,LENGTH(RptLength)!Число строк на странице хра-
!нится в переменной RptLength
!описания элементов отчета
. !Конец описаний отчета
См. также: Переполнение страницы
LINE (переменная - счетчик строк)
LINE(variable)
| variable | Метка числовой переменной. |
Атрибут отчета LINE задает переменную, которая станет счетчиком строк. При открытии отчета, эта переменная получает значение 1 и сбрасывается в единицу при каждом переполнении страницы. По мере печати HEADER, DETAIL или FOOTER, переменная увеличивается на число напечатанных строк. Эту переменную можно использовать, например, для нумерации строк отчета.
Пример:
CustRpt REPORT,LINE(LineNbr) !Счетчик - переменная LineNbr
!описания элементов отчета
. !Конец описаний отчета
См. также: Переполнение страницы
PAGE (переменная - счетчик страниц)
PAGE(variable)
| variable | Метка числовой переменной. |
Атрибут отчета PAGE задает переменную, которая будет использоваться как счетчик страниц. Эту переменную можно будет использовать для печати номера текущей страницы. При открытии отчета, переменная устанавливается в единицу, и увеличивается при переполнении страницы или под управлением программы.
Пример:
CustRpt REPORT,PAGE(PageCount) !Счетчик страниц - PageCount
!описания элементов отчета
. !Конец описаний отчета
PRINTER(name)
| name | Строковая константа, переменная или выражение содержащая имя принтера, в том виде, в котором оно задано в файле описаний принтеров. |
PRINTER задает логическую поддержку принтера для отчета. Параметр NAME содержит имя принтера, используемого для печати отчета, в том виде, в каком это имя заданно в файле описаний принтеров.
Файл описаний принтеров, по умолчанию, PRINTER.CTL. Можно изменить это имя, задав переменную окружения CLAPRINTER. Она может быть задана: в файле конфигурации программы (.INI-файле), в командной строке при выполнении программы, оператором SETCOMMAND или оператором ДОС SET.
Пример:
Report REPORT,PRINTER('EPSON LQ-1500')
!Используем Epson LQ-1500
!описания элементов отчета
.
CODE
SETCOMMAND(' CLAPRINTER=Control.Prn')
!Меняем файл описаний принтеров
OPEN(Report)
См. также: SETCOMMAND
WIDTH (максимальная ширина страницы)
WIDTH(value)
| value | Целочисленная константа от 1 до 255. |
Атрибут WIDTH задает максимальное количество символов в самой длинной строке отчета. Значение VALUE используется форматером отчетов для горизонтального позиционирования и центрирования.
Пример:
CustRpt REPORT,WIDTH(80) !Report, max width 80 columns
!описания элементов отчета
. !Конец описаний отчета
[метка] [HEADER[ALLOW()][FIXED][PRE()][SEPARATE()]
[ROW()]
[COL()]
[SUPPRESS()]
[метка] [STRING()]
[метка] [TEXT()]
[метка] [CONTROL()]
.]
| ALLOW | Сколько строк, как минимум, оставить на странице для печати DETAIL-структур. |
| FIXED | Объявляет заголовок фиксированной длины. |
| PRE | Префикс для элементов HEADER-структуры. |
| SEPARATE | Сколько строк пропустить после заголовка. |
| ROW | Номер строки для полей типа STRING, TEXT или CONTROL. |
| COL | Номер столбца для полей типа STRING, TEXT или CONTROL. |
| SUPPRESS | Не печатать строку, если она пустая. |
| STRING | Поле, содержащее значение переменной или символьная константа. |
| TEXT | Многострочное символьное поле. |
| CONTROL | Управляющая последовательность принтера. |
В HEADER-структуре задаются строки, которые печатаются в начале каждой страницы. HEADER-структура должна завершаться точкой или оператором END. В отчете может быть только один заголовок. Заголовок может быть явно выведен на печать оператором PRINT. Если этого не было, то он автоматически печатается при печати первой же структуры DETAIL, у которой нет атрибута ALONE. Заголовок автоматически печатается при переполнении страницы.
Пример:
CustRpt REPORT !Отчет о покупателях
Head HEADER ! начало описания заголовка
!элементы заголовка
. ! конец описания заголовка
. !Конец описаний отчета
См. также: Переполнение страницы
DETAIL(тело отчета)
[метка] [DETAIL[ALLOW()][ALONE][FIXED][PRE()][SEPARATE()]
[ROW()]
[COL()]
[SUPPRESS()]
[метка] [STRING()]
[метка] [TEXT()]
[метка] [CONTROL()]
.]
| ALONE | Структура DETAIL ДОЛЖНА печататься без заголовков или подножий. |
| ALLOW | Сколько строк, как минимум, оставить на странице для печати DETAIL-структур. |
| FIXED | Объявляет DETAIL как структуру фиксированной длины. |
| PRE | Префикс для элементов DETAIL-структуры. |
| SEPARATE | Сколько строк пропустить после DETAIL. |
| ROW | Номер строки для полей типа STRING, TEXT или CONTROL. |
| COL | Номер столбца для полей типа STRING, TEXT или CONTROL. |
| SUPPRESS | Не печатать строку, если она пустая. |
| STRING | Поле, содержащее значение переменной или символьная константа. |
| TEXT | Многострочное символьное поле. |
| CONTROL | Управляющая последовательность принтера. |
DETAIL-структура, это строки, составляющие тело отчета. Она должна заканчиваться точкой или оператором END. В отчете может быть несколько DETAIL-структур.
DETAIL-структура НИКОГДА не печатается автоматически, следовательно, она ДОЛЖНА быть явно напечатана оператором PRINT. Из-за этого, каждая DETAIL-структура отчета должна иметь свою метку.
DETAIL-структура может быть напечатана при необходимости. Поэтому можно иметь несколько DETAIL-структур, что даст возможность, скажем печатать необязательные заголовки и подножия для групп или печатать разные формы в зависимости от печатаемых данных.
Пример:
CustRpt REPORT !Отчет о покупателях
Head HEADER ! начало описания заголовка
!описания элементов структуры
. ! конец описания заголовка
GroupHead DETAIL ! начало описания DETAIL
!описания элементов структуры
. ! конец описания DETAIL
CustDetail DETAIL ! начало описания DETAIL
!описания элементов структуры
. ! конец описания DETAIL
. !Конец описаний отчета
См. также: PRINT
FOOTER (подножие страницы, нижний колонтитул)
[метка] [FOOTER[ALLOW()][FIXED][PRE()][SEPARATE()]
[ROW()]
[COL()]
[SUPPRESS()]
[метка] [STRING()]
[метка] [TEXT()]
[метка] [CONTROL()]
.]
| ALLOW | Сколько строк, как минимум, оставить на странице для печати DETAIL-структур. |
| FIXED | Объявляет FOOTER как структуру фиксированной длины. |
| PRE | Префикс для элементов FOOTER-структуры. |
| SEPARATE | Сколько строк пропустить после подножия. |
| ROW | Номер строки для полей типа STRING, TEXT или CONTROL. |
| COL | Номер столбца для полей типа STRING, TEXT или CONTROL. |
| SUPPRESS | Не печатать строку, если она пустая. |
| STRING | Поле, содержащее значение переменной или символьная константа. |
| TEXT | Многострочное символьное поле. |
| CONTROL | Управляющая последовательность принтера. |
Структура FOOTER содержит строки, которые печатаются в конце каждой страницы. FOOTER-структура ДОЛЖНА заканчиваться точкой или оператором END. В отчете может быть только одно подножие.
FOOTER автоматически печатается внизу страницы при переполнении страницы. Можно явно отпечатать подножие оператором PRINT. Подножие автоматически печатается внизу последней страницы при закрытии отчета, кроме того случая, когда последняя напечатанная DETAIL-структура не имела атрибута ALONE.
Пример:
CustRpt REPORT !Отчет по покупателям
Head HEADER ! начало описания заголовка
!описания элементов структуры
. ! конец описания заголовка
GroupHead DETAIL ! начало описания DETAIL
!описания элементов структуры
. ! конец описания DETAIL
CustDetail DETAIL ! начало описания DETAIL
!описания элементов структуры
. ! конец описания DETAIL
Foot FOOTER ! начало описания подножия
!описания элементов структуры
. ! конец описания подножия
. !Конец описаний отчета
ALLOW(value)
| value | Целочисленная константа или переменная, содержащая число строк. |
Атрибут ALLOW разработан для подавления "сирот", висячих строк, при печати. VALUE задает минимальное число строк, которое должно оставаться для печати DETAIL-структур после печати заголовков, подножий и других DETAIL-структур. Если для размещения DETAIL-структуры не хватает строк, то происходит ПЕРЕПОЛНЕНИЕ СТРАНИЦЫ.
Допустим, у отчета LENGTH(60) и 50 строк уже напечатано на странице (внутренний счетчик строк=51). Если подножие занимает 3 строки, то для DETAIL-структур остается 7 строк. Если DETAIL-структура занимает 5 строк, то все нормально - ей хватит места. Если же у DETAIL-структуры есть атрибут ALLOW(5), то произойдет ПЕРЕПОЛНЕНИЕ СТРАНИЦЫ перед печатью DETAIL-структуры. Элементарная арифметика: осталось 7 строк, минус 5 (которые займет сама DETAIL-структура) получим две. А 2, это несколько меньше, чем 5, требуемых атрибутом ALLOW(5).
Для вычисления свободного места на странице используются еще и значения атрибутов SEPARATE.
Пример:
CustRpt REPORT,LENGTH(60) !60 строк на странице отчета
Head HEADER
!описания элементов структуры
.
GroupHead DETAIL,ALLOW(5) !Must allow 5 CustDetail lines
!5 строк - элементы структуры ! after the group header
.
CustDetail DETAIL !Элементы DETAIL
!1 строка - элемент структуры
.
Foot FOOTER !Это подножие занимает до 3 строк
!3 строки - элементы структуры
.
. !Конец описаний отчета
ALONE
Этот атрибут говорит о том, что DETAIL-структуру надо печатать одну на странице без каких-либо HEADER и FOOTER. Возможное использование титульные листы отчетов и страницы ИТОГО.
Пример:
CustRpt REPORT !Отчет по покупателям
Head HEADER ! начало описания заголовка
!описания элементов структуры
. ! конец описания заголовка
TitlePage DETAIL,ALONE !DETAIL-структура титульного
!листа
!описания элементов структуры
. ! конец описания DETAIL
CustDetail DETAIL ! начало описания DETAIL
!описания элементов структуры
. ! конец описания DETAIL
Foot FOOTER ! начало описания подножия
!описания элементов структуры
. . ! конец подножия и отчета
FIXED
FIXED используется совместно с оператором SUPPRESS. Он гарантирует, что структура ВСЕГА будет занимать заданное число строк на странице. Хорошим примером этому могут служить почтовые этикетки, для которых иногда надо подавлять пустые строки, но сами этикетки должны иметь постоянную длину. FIXED дополняет структуру таким же количеством пустых строк, какое было пропущено оператором SUPPRESS (по-английски SUPRESSed :).
Пример:
CustRpt REPORT !Отчет по покупателям
Head HEADER ! начало описания заголовка
!описания элементов структуры
. ! конец описания заголовка
GroupHead DETAIL ! начало описания DETAIL
!описания элементов структуры
! конец описания DETAIL
.
CustDetail DETAIL,FIXED ! detail фиксированной длины
!описания элементов структуры
. ! конец описания DETAIL
Foot FOOTER ! начало описания подножия
!описания элементов структуры
. . ! конец подножия и отчета
SEPARATE(value)
| value | Целочисленная константа или переменная. |
Параметр атрибута SEPARATE задает число пустых строк, которые должны быть напечатаны сразу же после структуры.
Пример:
CustRpt REPORT !Отчет по покупателям
Head HEADER ! начало описания заголовка
!описания элементов структуры
. ! конец описания заголовка
GroupHead DETAIL,SEPARATE(2) !
!описания элементов структуры
! конец описания DETAIL
.
CustDetail DETAIL,SEPARATE(1) ! начало описания DETAIL
!описания элементов структуры
. ! конец описания DETAIL
Foot FOOTER ! начало описания подножия
!описания элементов структуры
. . ! конец подножия и отчета
ROW(row[,column])
| row | Целочисленная константа, которая задает абсолютный номер строки для полей типа STRING, TEXT или CONTROL в составе структур HEADER, DETAIL или FOOTER. |
| column | Целочисленная константа, которая задает абсолютный номер столбца в столбце для полей типа STRING, TEXT или CONTROL в составе структур HEADER, DETAIL или FOOTER. |
ROW используется для управления размещением полей в структурах HEADER, DETAIL или FOOTER. Для размещения поля в заданном месте структуры, ROW порождает переводы строк, возвраты каретки и пробелы.
Если пропущен параметр COLUMN, то поле помещается в первый столбец указанной строки. Параметр COLUMN порождает пробелы, как заполнитель для промежутков между полями.
Пример:
CustRpt REPORT !Отчет по покупателям
CustDetail DETAIL,SEPARATE(1) ! начало описания DETAIL
ROW(2,5) STRING(20),USE(Cus:Name)
!Cus:Name в строке 2 столбце 5
ROW(3) STRING(30),USE(Address)
!Address at row 3 col 1
. ! конец описания DETAIL
. !Конец описаний отчета
COL(column)
| column | Целочисленная константа, которая задает абсолютный номер столбца для полей типа STRING, TEXT или CONTROL, которые находятся в одной строке с полем, описанным ранее. |
COL используется для размещения полей в строке в структурах HEADER, DETAIL или FOOTER. COL порождает пробелы, чтобы заполнить промежутки между полями.
Пример:
CustRpt REPORT !Отчет по покупателям
CustDetail DETAIL,SEPARATE(l) ! начало описания DETAIL
ROW(2.5) STRING(15),USE(FirstName)
!FirstName в стр.2, стлб.5
COL(22) STRING(I).USE(Initial) !Initial в стлб.22
COL(24) STRING(15),USE(LastName)
!LastName в стлб.24
ROW(3) STRING(30),USE(Address)
!Address в стр.3 стлб.1
. ! конец описания DETAIL
. !Конец описаний отчета
SUPPRESS(строка)
| строка | Номер строки, которую НЕ печатать. |
SUPPRESS задает строку, которая не печатается, если все переменные на ней пусты. Обычно используется с атрибутом FIXED.
Пример:
CustLabels REPORT !Почтовые этикетки
CustDetail DETAIL,FIXED !detail постоянной длины
ROW(2,5) STRING(15),USE(Company)
ROW(3,5) STRING(1).USE(Contact)
ROW(4,5) STRING(15),USE(Addressl)
ROW(5,5) STRING(15),USE(Address2)
Citystzip ROW(6,5) STRING(15)
SUPPRESS(5) !Поле Address2 пусто?
!Не печатать строку 5
. . !конец detail и отчета
| length |
[метка] CONTROL( |constant| )[,USE()]
| picture|
| length | Целочисленная константа. Должна быть такой же, как и длина USE-переменной. |
| constant | Строковая константа, посылаемая на принтер. |
| picture | Форматирует значение, присвоенное CONTROL-полю, или значение USE-переменной. LENGTH это размер, достаточный для хранения ОТФОРМАТИРОВАННОЙ строки. Изначально, PICTURE заполнена пробелами. |
| USE | Переменная, содержащая управляющую последовательность. Должна быть такой длины, какая задана параметром LENGTH. |
CONTROL задает символьную строку, которая управляет действиями принтера. CONTROL-поле не влияет на положение полей типа STRING или TEXT. Однако, это поле может использоваться для изменения управляющих кодов для любых следующих за ним полей типа STRING или TEXT (СПА: здесь я совсем не уверен, как перевести fields that occur following the CONTROL declaration.)
Если у CONTROL есть атрибут USE, то на принтер посылается управляющая последовательность, которая содержится в USE-переменной. Таким образом можно хранить последовательности для разных типов принтеров, и присваивать USE-переменной нужную для используемого в данный момент принтера.
Если у отчета есть атрибут PRINTER, то строковая константа или USE-переменная должна содержать имя принтера, как он описан в файле управления принтерами (PRINTER.CTL).
Пример:
PrinterType STRING('EPSON LQ-1500')
ItalicOn STRING('ITALIC ON')
CustRpt REPORT,PRINTER(PrinterType) !Отчет по покупателям
CustDetail DETAIL,SEPARATE(1) ! начало описания DETAIL
ROW(2,5) CONTROL(4),USE(ItalicOn)
!Управляем из переменной
!ItalicOn - включить курсив
ROW(2,5) STRING(15),USE(FirstName)
COL(22) STRING(15),USE(LastName)
ROW(3,1) CONTROL('COMPRESSED ON')
!А этот Control из printer.ctl
ROW(3) STRING(30),USE(Address)
. . !Конец описаний отчета
См. также: PRINTER
STRING (переменная отчета)
| length | |LFT | |UPR|
[метка] STRING(|constant|)[,USE][,|RHT |][,|LWR|][,CLIP]
| picture| |CENT| |CAP|
| length | Числовая константа, задающая длину строки. В этом случае строка состоит из пробелов. |
| constant | Строковая константа. Длина строки становится равной длине константы. |
| picture | Используется для форматирования значения строки или ее USE-переменной. В этом случае длина строки это размер, достаточный для хранения отформатированной строки. Изначально строка заполняется пробелами. |
| USE | Задает переменную, со значением которой оперирует STRING. |
| LFT, RHT, CENT Задает способ выравнивания текста в строке: влево, вправо или по центру соответственно. | |
| UPR, LWR, CAP Задает режим капитализации строки - верхний регистр, нижний регистр, первая буква заглавная. | |
| CLIP | Указывает, что из строки надо удалять хвостовые пробелы. |
STRING описывает переменную отчета в позиции, заданной ROW или COL в структурах HEADER, DETAIL или FOOTER. Если не заданы ROW или COL, то STRING печатается в первом столбце справа от предыдущего поля. Если STRING имеет метку, то к ней можно обратиться, когда структура REPORT открыта или закрыта.
Пример:
CustRpt REPORT,PRINTER(PrinterType)!Отчет по покупателям
CustDetail DETAIL,SEPARATE(1) ! начало описания DETAIL
ROW(2,5) STRING(15),USE(FirstName),CLIP
STRING(' ')
STRING(1),USE(Initial)
STRING('. ')
STRING(15),USE(LastName)
ROW(3,5) STRING(30),USE(Address)
.
ProdDetail DETAIL
ROW(1) STRING('Товар:')
!Печатаем строковую константу
COL(10) STRING(@n3),USE(Itm:ProductNbr)
COL(20) STRING(@n2),USE(Itm:Quantity)
ExtPrice COL(34) STRING(12) !форматируется программой (?)
.
.
|LFT | |UPR|
[метка] TEXT(rows,colomns)[,USE()][,|RHT |][,|LWR|][,|CLIP|]
|CENT| |CAP| |WRAP|
| rows | Сколько строк (максимум) печатать. s |
| USE | Задает переменную, со значением которой оперирует STRING. |
| LFT, RHT, CENT | Задает способ выравнивания текста в строке: влево, вправо или по центру соответственно. |
| UPR, LWR, CAP | Задает режим капитализации строки - верхний регистр, нижний регистр, первая буква заглавная. |
| CLIP | Указывает, что из строки надо удалять хвостовые пробелы. |
| WRAP | Разрешить перенос слов. |
Поле типа TEXT позволяет печатать многострочные тексты. ROWS задает максимальную высоту в строках, COLUMNS - ширину в столбцах. USE-перемене разделяются на сегменты по COLUMNS символов. Печатается до ROWS сегментов. Если сегментов меньше чем ROWS, то печатаются только сегменты, содержащие данные.
Пример:
CustRpt REPORT,PRINTER(PrinterType) !Отчет по покупателям
ProdDetail DETAIL !Declare the detail line
ROW(1) STRING('Product:')
COL(10) STRING(@n3),USE(Itm:ProductNbr)
COL(20) STRING(@n2),USE(Itm:Quantity)
ExtPrice COL(34) STRING(12)
ROW(2,5) TEXT(5,50),USE(Pro:Desc)
! 50 столбцов, до 5 строк
. !End detail
. !Конец описаний отчета
CLIP
Атрибут CLIP удаляет из поля хвостовые пробелы.
Пример:
CustRpt REPORT
CustDetail DETAIL,SEPARATE(l)
ROW(2,5) STRING(15),USE(FirstName),CLIP
!FirstName в стр.2 стлб.5
! усекается и сразу за ним
STRING(' ') ! идет один пробел
STRING(1),USE(Initial)
!Initial в следующем стлб.
! За ним идет точка и еще
STRING('. ') ! один пробел
STRING(15),USE(LastName)
!LastName в следующем стлб.
COL(45) STRING(@P(###)###-####P),USE(Phone)
!Phone в стр.2 стлб.45
. .
LFT
RHT
CENT
LFT выравнивает влево, RHT - вправо, а CENT центрирует текст в поле. Эти атрибуты разрешены с полями типа STRING и TEXT.
Пример:
CustRpt REPORT
Head HEADER,SEPARATE(1)
ROW(2,25) STRING(30),USE(Company).CENT
. !Центрировать название фирмы
CustDetail DETAIL,SEPARATE(1)
ROW(2,5) STRING(15),USE(FirstName),RHT
!Имя выровнять вправо
COL(22) STRING(1).USE(Initial)
COL(24) STRING(15),USE(LastName),LFT
!а фамилию - влево
. .
UPR
LWR
CAP
Поля типа STRING, TEXT или CONTROL с атрибутом UPR выводят все буквы заглавными. Атрибут LWR печатает все в нижнем регистре. Атрибут CAP выводит текст в формате ИМЕНИ первая буква каждого слова заглавная, а остальные - строчные.
Пример:
CustRpt REPORT
Head HEADER,SEPARATE(1)
ROW(2,25) STRING(30),USE(Company),CENT,UPR
!заглавными
ROW(3,25) STRING(30),USE(Motto),CENT,LWR
!прописными
.
CustDetail DETAIL,SEPARATE(1)
ROW(2,5) STRING(15).USE(FirstName),CAP
!Как имя
COL(22) STRING(l),USE(Initial),UPR!Заглавными
COL(24) STRING(15),USE(LastName),CAP
!Как имя
ROW(3) STRING(30),USE(Address)
. .
USE(variable)
| variable | Метка переменной. |
Атрибут USE задает переменную, значение которой передается в поля отчета STRING, TEXT или CONTROL. Когда оператором PRINT или при переполнении страницы, печатаются структуры HEADER, DETAIL, или FOOTER, значения USE-переменных печатаются в связанных с ними полях STRING, TEXT или CONTROL.
Пример:
CustRpt REPORT
Head HEADER
ROW(1,1) CONTROL(5),USE(Boldon)
ROW(2,25) STRING(30),USE(Company),CENT,UPR
!Заглавными
ROW(3.1) CONTROL(5),USE(BoldOff)
ROW(3,25) STRING(30).USE(Motto),CENT,LWR!Строчными
.
CustDetail DETAIL,SEPARATE(1)
ROW(2,5) STRING(15),USE(FirstName)
COL(22) STRING(1),USE(Initial)
COL(24) STRING(15).USE(LastName)
ROW(3) STRING(30),USE(Address)
.
ProdDetail DETAIL
ROW(1) STRING('Product:')
COL(10) STRING(@n3),USE(Itm:ProductNbr)
COL(20) STRING(@n2),USE(Itm:Quantity)
ExtPrice COL(34) STRING(12)
ROW(2,5) TEXT(5,50),USE(Pro:Desc)
.
. !Конец описаний отчета
WRAP
Атрибут WRAP разрешает перенос слов в полях типа TEXT. Перенос слов гарантирует, что слова, не вмещающиеся в текущую будут перенесены в начало следующей, для чего в конец текущей строки добавляются пробелы.
Пример:
CustRpt REPORT,PRINTER(PrinterType)
ProdDetail DETAIL
ROW(1) STRING('Product:')
COL(10) STRING(@n3),USE(Itm:ProductNbr)
COL(20) STRING(@n2),USE(Itm:Quantity)
ExtPrice COL(34) STRING(12)
ROW(2,5) TEXT(5,50),USE(Pro:Desc),WRAP
!Разрешен перенос слов
. .
OPEN(report)
| report | Метка структуры REPORT. |
OPEN активизирует структуру REPORT. Вы должны открыть отчет прежде, чем сможете напечатать какую-либо структуру типа HEADER, DETAIL или FOOTER. К переменным отчета (полям с метками) можно обращаться НЕзависимо от того, открыт отчет или нет.
Пример:
OPEN(CustRpt) !Открыть отчет
CLOSE(report)
| report | Метка структуры REPORT. |
Оператор CLOSE печатает структуру FOOTER (если, конечно, последняя напечатанная структура DETAIL не имела атрибута ALONE), закрывает отчет и его выходной файл (если атрибут DEVICE указывал на файл). RETURN из процедуры, открывшей отчет, неявно вызывает CLOSE.
Пример:
CLOSE(CustRpt) !Закрыть отчет
PRINT( |structure|)
| string |
| structure | Метка структуры HEADER, DETAIL или FOOTER. |
| string | Строковое выражение, переменная или символ управления принтером. Этот параметр игнорирует атрибут DEVICE и выводит строку на устройство PRN (LPT1). |
Оператор PRINT выводит элемент отчета на заданное атрибутом DEVICE устройство. PRINT автоматически увеличивает счетчики строк и страниц и вызывает, при необходимости, переполнение страницы.
PRINT также может вывести строку непосредственно на LPT1.
Пример:
PRINT( 'Итого:'& FORMAT( Filetot @N10.2) & @LF)
!Печатаем ИТОГО и ПС на LPT1
PRINT(@FF) !Выбросить лист (ПФ) из LPT1
PRINT(OrderDtl) !Вывести строку из счета на DEVICE
См. также: Переполнение страницы, Шаблоны управляющих кодов принтера
ROWS (количество строк)
ROWS(structure)
| structure | Метка структуры REPORT. |
Функция ROWS возвращает число строк, которые займет при печати тот или иной элемент отчета (HEADER, DETAIL или FOOTER). Результат НЕ включает в себя значение атрибута SEPARATE, но строки с атрибутом SUPPRESS учитываются.
Возвращаемый тип данных: LONG
Пример:
IF Length - Line > ROWS(Detail)
!Хватит ли места, чтобы распечатать
! Detail целиком?
PRINT(Detail) ! если да, то печатаем
ELSE ! если нет, то
PRINT(Footer) ! сначала перейдем на новую страницу
PRINT(Header) !
PRINT(Detail) ! а уже затем напечатаем Detail
.
Переполнение страницы происходит, когда PRINT не может разместить структуру DETAIL на странице или когда недостаточно места, чтобы после структуры DETAIL оставить столько места, сколько задано ее атрибутом ALLOW. Ниже описано, что происходит при ПЕРЕПОЛНЕНИИ СТРАНИЦЫ.
Если есть FOOTER, то добавляются переводы строк так, чтобы FOOTER попал в самый низ страницы (согласно атрибуту LENGTH). Затем печатается собственно FOOTER.
Счетчик страниц увеличивается, а счетчик строк сбрасывается в единицу.
Если есть HEADER, то он печатается и счетчик строк увеличивается на число строк, занятых под FOOTER.
@FF[n] Перевод листа (ПФ, Form feed, FF, ASCII 12)
повторить n раз, затем выдать ВК.
@LF[n] Перевод строки (ПС, Line feed, LF, ASCII 10)
повторить n раз.
@CR[n] Возврат каретки (ВК, Carriage return,
ASCII 13) повторить n раз.
n Целочисленная константа, задающая сколько
раз повторить этот код. По умолчанию - один.
Шаблоны управляющих кодов принтера представляют собой общие последовательности управления принтером. Аналогично шаблонам формата, шаблоны управления принтером начинаются со знака @. Эти шаблоны можно использовать совместно с оператором PRINT.
Пример:
PRINT(@LF3) ! 3 ПС PRINT(@CR4) ! 4 ВК PRINT(@FF) ! 1 ПФ
Назад | Содержание | Вперед