Как открыть форму в режиме выбора в 1С

Режим выбора — это специальное состояние формы списка или формы объекта, при котором пользователь не редактирует данные, а выбирает один или несколько элементов для подстановки в поле ввода, табличную часть или переменную. В управляемом приложении 1С:Предприятие 8.3 форма открывается в режиме выбора либо автоматически (при нажатии кнопки выбора в поле ввода), либо программно — через методы ОткрытьФорму и ОткрытьФормуМодально с соответствующими параметрами.

Программное открытие формы выбора нужно, когда стандартного механизма недостаточно: требуется предустановленный отбор, множественный выбор, открытие из собственной команды или обработка результата нестандартным образом. Ниже разобраны оба способа, параметры, обработка результата и типичные ошибки.

Какие способы открытия формы выбора существуют

Платформа предоставляет два основных подхода. Первый — стандартный: у поля ввода со ссылочным типом данных автоматически работают кнопка выбора, выбор из списка и ввод по строке. Разработчику ничего программировать не нужно, но и управлять поведением формы почти невозможно.

Второй подход — программный вызов. Метод ОткрытьФорму открывает форму в немодальном режиме и возвращает управление сразу, а результат приходит через механизм оповещений. Метод ОткрытьФормуМодально блокирует интерфейс до закрытия формы и возвращает выбранное значение напрямую, но в конфигурациях с режимом использования модальности «Не использовать» он приведёт к ошибке. Поэтому в современных решениях применяют первый вариант.

Открытие формы выбора через ОткрытьФорму

Базовый вызов выглядит так: указывается полное имя формы выбора объекта метаданных, структура параметров и владелец формы. Владельцем обычно назначают текущую форму или конкретное поле ввода — тогда результат выбора автоматически попадёт в него через событие ОбработкаВыбора.

&НаКлиенте
Процедура ВыбратьНоменклатуру(Команда)

	ПараметрыФормы = Новый Структура;
	ПараметрыФормы.Вставить("РежимВыбора", Истина);
	ПараметрыФормы.Вставить("ЗакрыватьПриВыборе", Истина);

	ОткрытьФорму("Справочник.Номенклатура.ФормаВыбора",
		ПараметрыФормы,
		Элементы.Номенклатура);

КонецПроцедуры

Ключевой параметр — РежимВыбора со значением Истина. Он переводит форму списка в состояние выбора: активируется команда «Выбрать», двойной щелчок по строке трактуется как выбор, а при закрытии формы владельцу отправляется выбранное значение. Параметр ЗакрыватьПриВыборе управляет тем, закроется ли форма после выбора элемента.

Если форма открывается с владельцем-полем ввода, дополнительно писать обработчик не нужно: платформа сама присвоит выбранное значение полю. Если владельцем назначена сама форма (ЭтаФорма), результат придёт в событие ОбработкаВыбора, где его нужно обработать вручную.

Обработка результата выбора

Существует два канала получения результата. Первый — событие ОбработкаВыбора управляемой формы. Оно срабатывает, когда форма выбора закрывается с результатом и у неё указан владелец. В параметре ВыбранноеЗначение приходит ссылка на элемент или массив при множественном выборе.

&НаКлиенте
Процедура ОбработкаВыбора(ВыбранноеЗначение, ИсточникВыбора)

	Если ТипЗнч(ВыбранноеЗначение) = Тип("СправочникСсылка.Номенклатура") Тогда
		Объект.Номенклатура = ВыбранноеЗначение;
	КонецЕсли;

КонецПроцедуры

Второй канал — описание оповещения о закрытии. Оно передаётся четвёртым параметром в ОткрытьФорму и вызывается при закрытии формы независимо от того, был ли совершён выбор. Если пользователь закрыл форму без выбора, в обработчик придёт Неопределено — это обязательно нужно проверять.

&НаКлиенте
Процедура ВыбратьКонтрагента(Команда)

	Оповещение = Новый ОписаниеОповещения("ПослеВыбораКонтрагента", ЭтотОбъект);
	ПараметрыФормы = Новый Структура("РежимВыбора", Истина);

	ОткрытьФорму("Справочник.Контрагенты.ФормаВыбора",
		ПараметрыФормы, ЭтаФорма, , , , Оповещение);

КонецПроцедуры

&НаКлиенте
Процедура ПослеВыбораКонтрагента(Результат, ДопПараметры) Экспорт

	Если Результат = Неопределено Тогда
		Возврат;
	КонецЕсли;

	Объект.Контрагент = Результат;

КонецПроцедуры

Отборы, множественный выбор и другие параметры

Часто форму выбора нужно открыть уже с ограничением списка: например, показать только непомеченных на удаление контрагентов или номенклатуру определённого вида. Для этого в параметры добавляют ключ Отбор — структуру, где имя свойства совпадает с именем поля динамического списка, а значение — искомым значением или массивом значений.

ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("РежимВыбора", Истина);
ПараметрыФормы.Вставить("МножественныйВыбор", Истина);
ПараметрыФормы.Вставить("Отбор", Новый Структура("ПометкаУдаления", Ложь));

Полезные параметры формы выбора, поддерживаемые большинством типовых форм:

• РежимВыбора — включает режим выбора;
• МножественныйВыбор — разрешает выбор нескольких элементов, результат приходит массивом;
• ЗакрыватьПриВыборе — закрывать форму после выбора (при множественном выборе обычно ставят Ложь);
• Отбор — структура отбора динамического списка;
• ТекущаяСтрока — ссылка на элемент, который будет спозиционирован при открытии;
• ВыборГруппИЭлементов — для иерархических справочников: разрешить выбор групп, элементов или и того и другого.

Открытие формы выбора из поля ввода и связи параметров

Если задача — заменить поведение стандартной кнопки выбора у поля ввода, используют событие поля НачалоВыбора. Внутри обработчика устанавливают СтандартнаяОбработка = Ложь и открывают свою форму, передавая владельцем сам элемент. Тогда результат автоматически попадёт в поле, а событие ОбработкаВыбора у формы можно не реализовывать.

Для зависимых полей (например, договор зависит от контрагента) не обязательно программировать отбор вручную. У поля ввода есть свойство СвязиПараметровВыбора, где настраивается связь «Отбор.Владелец» с реквизитом формы — платформа сама передаст отбор в форму выбора. Программный вариант нужен лишь тогда, когда логика отбора сложнее простого равенства.

1. 1
   Определите имя формы выбора: основная форма объекта или своя форма в конфигураторе
2. 2
   Сформируйте структуру параметров: РежимВыбора, при необходимости Отбор и МножественныйВыбор
3. 3
   Вызовите ОткрытьФорму, указав владельца — поле ввода или форму
4. 4
   Если владелец — форма, реализуйте ОбработкаВыбора или передайте ОписаниеОповещения
5. 5
   Проверьте результат на Неопределено перед использованием
6. 6
   Протестируйте открытие, выбор и отказ от выбора в тонком и веб-клиенте

Типичные ошибки и ограничения

Отдельное ограничение касается толстого клиента и обычных форм: там используется другой API (ПолучитьФорму, свойство РежимВыбора у формы), и код управляемого приложения напрямую не переносится. Если конфигурация поддерживает оба режима, логику выбора выносят в общие модули с учётом режима запуска.

Ещё одна граница самостоятельной доработки — изменение типовых форм выбора. Правильнее создать собственную форму выбора или расширение конфигурации, а не править типовую форму напрямую: иначе при обновлении конфигурации изменения будут потеряны или потребуют трудоёмкого сравнения.

Проверка результата и контрольные точки

После внедрения кода проверьте три сценария: успешный выбор, отмену (закрытие формы крестиком или Esc) и повторное открытие формы. При отмене значение реквизита не должно изменяться. При повторном открытии форма должна позиционироваться корректно, а отбор — применяться заново.

Частые вопросы