Параметры формы — это значения, которые можно передать в форму при ее открытии. Они используются для настройки и управления формой, а также для передачи данных между формами.
Типы параметров формы
Существует два типа параметров формы⁚
- Системные — параметры, имена которых предопределены на уровне платформы, такие как⁚
- `Формат` — формат отображения данных в форме.
- `Режим` — режим работы формы, например, просмотр или редактирование.
- `Заголовок` — заголовок формы.
- Пользовательские — параметры, которые разработчик задает индивидуально для каждой формы. Пользовательские параметры, в свою очередь, делятся на⁚
- Параметры значения, используются для передачи произвольных значений в форму.
- Параметры ссылки — используются для передачи ссылок на объекты в форме;
- Параметры объекта — используются для передачи целых объектов в форму.
Настройка параметров формы
Настройка параметров формы выполняется в Конструкторе управляемой формы на закладке Параметры.
1. Добавьте новый параметр с помощью кнопки Добавить.
2. Укажите тип параметра (значение, ссылка или объект).
3. Задайте имя и заголовок параметра.
4. При необходимости установите значение по умолчанию и другие параметры.
Обработка заполнения параметров формы
Для обработки заполнения параметров формы в модуле формы используются обработчики событий⁚
- ПриСозданииНаСервере — вызывается при создании формы на сервере.
- ПриОткрытии — вызывается при открытии формы пользователю.
В этих обработчиках можно⁚
- Получить переданные параметры формы с помощью метода `ПараметрыФормы`.
- Установить значения реквизитов формы на основе полученных параметров.
- Выполнить дополнительные действия в зависимости от переданных параметров.
Пример
Рассмотрим пример обработки заполнения параметра формы, который передает ФИО сотрудника и подставляет его в наименование нового элемента справочника Физические лица.
1. В Конструкторе управляемой формы добавим новый параметр `ФамилияИмяОтчество` типа Параметр значения.
2. В модуле формы добавим следующий код в обработчик события ПриОткрытии⁚
&НаКлиенте
Процедура ПриОткрытии(Отказ, СтандартнаяОбработка)
// Получаем значение переданного параметра
ФамилияИмяОтчество = ПараметрыФормы.ФамилияИмяОтчество;
// Устанавливаем значение реквизита «Наименование»
ЭлементФормы.Наименование.Значение = ФамилияИмяОтчество;
КонецПроцедуры
3. В коде формы для открытия формы используем следующий код⁚
ОткрытьФорму(«Справочник.ФизическиеЛица.ФормаЭлемента», Новый Структура(«ФамилияИмяОтчество», ФамилияИмяОтчество));
Обработка заполнения параметров формы позволяет передавать данные и настраивать форму в соответствии с требованиями. Это делает формы более гибкими и удобными в использовании.