Руководство разработчика

Режимы табличных форм

Для табличных форм предусмотрены четыре режима:

  1. Просмотр статической части.
  2. Редактирование статической части.
  3. Просмотр статической и интерактивной частей.
  4. Редактирование статической и интерактивной частей.

Для двух первых режимов не требуются какие-либо исходные тексты и внутренний язык вообще. 3-ий и 4-й режимы аналогичны показу и редактированию бланков и диалогов.

Для просмотра только статической части табличной формы (режим 1) используется программа Просмотр табличных форм (tfviewer.exe). Режим просмотра подразумевает, что пользователь не может изменять данные ячеек, размеры строк и столбцов, если это запретил разработчик формы. Для изменений статической части действует механизм отката. Если изменения в статическую часть все-таки были внесены, то при закрытии окна будет выдан запрос (да/нет/отмена) на сохранение изменений в файл. Данный режим может применяться только для форм, не требующих получения и записи данных, т.е. документов ручного заполнения и без какой-либо регистрации.

Для редактирования только статической части табличной формы (режим 2) используется открытие ibf файла в среде разработки (Файлы/Открыть как...). После выбора типа файла Табличная форма открывается диалог выбора файла в подпапке "forms" рабочей папки программы. Пользователь может выбрать существующий файл или ввести имя нового файла. Во втором случае будет создана новая статическая часть табличной формы. Форма создается с неким начальным наполнением: одним регулярным разделом, 5 столбцами и 10 строками. Как при выборе существующего файла, так и при создании нового, открывается редактор статической части. Редактор статической части позволяет осуществить любые изменения статической части. Даже если изначально статическая часть использовалась совместно с какими-то интерактивными частями (режимы 3 и 4), то с помощью режима 2 можно внести в нее изменения. Это качество может понадобиться, когда нет доступа к исходным текстам интерактивных частей или квалификация пользователя недостаточна для использования интегрированной среды разработки. Прикладные разработчики могут использовать этот режим для рисования внешних образов форм или фрагментов форм на начальном этапе разработки с последующим переходом к режиму 4.

Для просмотра статической и интерактивной частей (режим 3) используется программа внутреннего языка. В программе должна создаваться переменная табличной формы (тип ТАБ_ФОРМА) и вызываться метод ее показа. Кроме ячеек табличной формы на экране отображаются связанные с ячейками элементы управления. Пользователь может взаимодействовать как со статической частью табличной формы, так и с элементами управления. В отличие от режима 1, при закрытии окна сохранения статической части автоматически не происходит. При необходимости можно вызвать метод сохранения в обработчике закрытия формы. Заполнение формы данными происходит путем вызова методов переменной формы. Допускаются сколь угодно сложные изменения статической части как до показа, так и во время показа на экране. Имеется программный доступ к механизму отката изменений статической части. Элементы управления выполняют вспомогательную роль и в откате не участвуют. Этот режим просмотра табличных форм следует считать основным. Вызов программы показа табличной формы может происходить из пункта меню типа "Алгоритм", системы бланков, события и т.д. Для создания программы показа табличной формы используется интегрированная среда разработки (режим 4).

Совместное редактирование статической и интерактивной частей табличной формы (режим 4) осуществляется с помощью интегрированной среды разработки. Помимо всех возможностей редактирования статической части (режим 2), добавляются возможности добавления/удаления и редактирования элементов управления, редактирования полей переменной формы и создания обработчиков событий. Для создания нового проекта табличной формы выберите стандартный пункт меню Файл/Новый проект. Выберите шаблон проекта "Табличная форма" и введите имя нового проекта. Мастер создаст проект, где объявляется тип, производный от табличной формы, создается переменная этого типа и вызывается метод ее показа. Для входа в режим редактирования табличной формы нажмите кнопку Редактор форм на панели инструментов интегрированной среды разработки или выберите пункт меню Проект/Редактировать форму. Т.к. наша табличная форма пока не связана ни с каким файлом статической части, то появится диалог выбора файла. Можно выбрать какой-либо существующий файл статической части или ввести имя нового файла. По умолчанию предлагается имя файла соответствующее имени типа табличной формы. После этого открывается редактор, представляющий собой гибрид редактора статической части и редактора бланка/диалога. Данный режим позволяет согласованно редактировать статическую и интерактивную части, отлаживать программу заполнения формы и ее интерактивное поведение.

См. также: