Использование форматера

Форма становится доступной после объявления ее в разделе form.

Раздел form следует после описания логической таблицы и параметров.

Синтаксис раздела form:

<раздел форм> ::= {form <описание одной формы>
				 {<описание одной формы>}};

<Описание одной формы> ::=
  <Идентификатор формы>
  ( <Имя выходного файла, возможны макросы>
  [,<Имя формы, если оно не совпадает с идентификатором формы>]
  ) [with visual <Атрибуты визуализации> | [with novisual]];

При описании формы указывается ее идентификатор, с помощью которого прикладной алгоритм будет обращаться к методам формы.

В имени выходного файла можно использовать метапеременные типа %USER%. Если указано только имя файла, то файл кладется в директорию указанную в параметре /o:.

При выводе в форму автоматически включается визуализация. Для ее отключения необходимо в описании атрибутов формы указать with novisual. При генерации отчета функция NextVisual будет работать с визуализацией формы.

Визуализация позволяет прервать процесс вывода в форму. Для корректного прерывания процесса необходимо в каждый цикл вывода включить как условие продолжения and not <имя формы>.Error. Функция Error начинает возвращать false, если пользователь прервал процесс или произошла какая-либо ошибка. После ошибки все методы работы с формой начинают игнорироваться, метод ShowFile вместо показа результата выдает сообщение об ошибке. Для переинициализации формы необходимо вызвать метод AbortForm.

<атрибуты визуализации> ::=
   ( <строка сообщения>[, <количество шагов>] )

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

Методы форматера можно вызывать из обработчика событий или из тела процедуры.

Список методов форматера приведен в разделе "Методы форм для интерфейсов. ".

Перед вызовом метода надо ставить идентификатор формы.

Пример.

Form MyForm('OUT\%USER%\MyReport.out');
....
MyForm.Write(MyTable.myField + 2, 0);
MyForm.Write(MyTable.myDate, 'DD-MM-YYYY');