Структура модуля--------------------------------------------------------------------------------
В программном модуле в общем случае могут присутствовать следующие разделы в приведенной ниже последовательности:
• заголовок модуля;
• раздел описания переменных;
• процедуры и функции модуля;
• обработчики событий элементов формы;
• обработчики событий;
• раздел инициализации.
Некоторые разделы могут присутствовать только в модулях определенного вида. Например, обработчики событий элементов форм могут присутствовать только в модулях форм, а раздел описания переменных и раздел инициализации не могут быть определены в неглобальных общих модулях, модулях менеджеров объектов, наборов записей, значений констант и модуле сеанса.
Допускается располагать процедуры и функции в особом порядке, если такое расположение лучше иллюстрирует логику работы модуля. Например, если некоторая процедура вызывается из обработчика события элемента формы, то правильным будет расположить их одну за другой, а не "разносить" в разные разделы.
Заголовок модуля Заголовок модуля представляет собой комментарий в самом начале модуля.
В заголовке модуля приводится его краткое описание и условия применения.
Для общих модулей заголовок является обязательным.
Раздел описания переменных Переменным модуля обычного приложения, модуля управляемого приложения и внешнего соединения назначается префикс "гл".
Экспортные переменные модуля должны быть снабжены комментарием, достаточным для понимания их назначения. Для не экспортных переменных наличие комментария желательно, но не обязательно.
Комментарий рекомендуется размещать в той же строке, где объявляется переменная.
Пример:
Перем глВалютаУчета Экспорт; // Валюта, в которой ведется учет
Перем глАдресПоддержки Экспорт; // Адрес электронной почты, куда направляются сообщения об ошибках
Процедуры и функции модуля Процедуры и функции, которые не являются обработчиками событий размещаются сразу же после описания переменных. Процедуры и функции, связанные между собой по характеру работы или логике работы рекомендуется располагать вместе.
Обработчики событий элементов формы После процедур и функций в модуле формы располагают обработчики событий элементов формы. Рекомендуется обработчики одного элемента формы располагать вместе, придерживаясь, при этом, порядка их следования в описании встроенного языка.
У каждого события должен быть свой обработчик. Если одинаковые действия должны выполняться при возникновении событий в разных элементах формы следует:
• создать отдельную процедуру (функцию), выполняющую необходимые действия;
• для каждого элемента формы создать отдельный обработчик с именем, назначаемым по умолчанию;
• из каждого обработчика вызвать требуемую процедуру (функцию).
Обработчики событий Последними из процедур располагаются обработчики событий модуля (формы, объекта, менеджера объекта и т.д.). Для них также рекомендуется придерживаться порядка следования, приведенного в описании встроенного языка.
Раздел инициализации Раздел инициализации содержит операторы, инициализирующие переменные модуля или объект (форму).