При открытии формы можно передать ей набор данных заполнения‚ который она получила бы‚ если бы открывалась интерактивной командой. Это позволяет заполнить поля формы значениями по умолчанию или предварительно введенными данными.
Синтаксис
ОткрытьФорму(<ИмяФормы>‚ <ЗначениеКопирования>‚ <ЗначенияЗаполнения>)
где⁚
- `<ИмяФормы>` ⎼ имя открываемой формы;
- `<ЗначениеКопирования>` ⎼ значение‚ определяющее‚ нужно ли копировать открываемую форму или создать ее новую копию. Допустимые значения⁚
- `Истина` ⏤ создать новую копию формы;
- `Ложь` ⎼ копировать существующую форму;
- `Пустое значение` ⎼ копировать форму‚ если она уже открыта‚ иначе создать новую копию;
- `<ЗначенияЗаполнения>` ⎼ структура‚ содержащая значения‚ которые нужно заполнить в полях формы.
Пример
// Создать новую копию формы «Справочник контрагентов» с заполненным полем «Наименование»
Структура ЗначенияЗаполнения;
ЗначенияЗаполнения.Наименование = «Новый контрагент»;
ОткрытьФорму(«СправочникКонтрагентов»‚ Истина‚ ЗначенияЗаполнения);
В этом примере при открытии формы «Справочник контрагентов» будет создана ее новая копия‚ а поле «Наименование» будет заполнено значением «Новый контрагент».
Важные замечания
- Если значение поля не передается в структуре `<ЗначенияЗаполнения>`‚ то оно будет заполнено значением по умолчанию.
- Если в структуре `<ЗначенияЗаполнения>` передано значение поля‚ которого нет в открываемой форме‚ то оно будет проигнорировано.
- При програмном открытии формы можно передать ей только предопределенные значения‚ которые поддерживаются платформой. Например‚ нельзя передать в качестве значения заполнения объект управляемого типа.
- Использование `<ЗначенияЗаполнения>` не приводит к созданию новой записи в базе данных.