Методы контекста Модуля формы
Описанные в данном разделе методы доступны только в контексте Модуля формы (см. "Виды программных модулей"). К модулям форм относятся практически все программные модули (исключение составляют Глобальный модуль, Модуль документа, Модуль вида расчета).
ОткрытьПодбор
Открыть форму для подбора значений.
Синтаксис:
ОткрытьПодбор(<ИмяОбъекта>, <ИмяФормы>, <КонтекстФормы>, <ФлагМножВыбора>, <ТекЗнач>)
Англоязычный синоним:
OpenPermanentChoice
Параметры:
| <ИмяОбъекта> | Строковое выражение – имя объекта агрегатного типа, форму списка которого требуется открыть для подбора. Можно указывать справочник, журнал, документ (при указании документа открывается форма журнала для указанного документа). Имя объекта задается в следующем виде:
|
| <ИмяФормы> | Строковое выражение – имя формы подбора, как она задана в конфигураторе. Поскольку и справочники и журналы могут иметь несколько форм представления, то этим параметром можно конкретно указать, какая из форм представления объекта вызывается для подбора значений. |
| <КонтекстФормы> | Необязательный параметр. Имя переменной, куда можно задать значение любого типа для передачи в открываемую форму. Данное значение будет доступно в открытой форме как атрибут Форма.Параметр. После исполнения данного метода система вернет в данную переменную контекст формы подбора (см. "Передача контекста в качестве параметра"). С помощью значения этого контекста можно затем произвольно манипулировать формой подбора, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта – 0. |
| <ФлагМножВы6ора> | Необязательный параметр. Число: 1 – выбор нескольких значений; 0 – выбор одного значения, после чего окно закрывается. Значение по умолчанию: 1. |
| <ТекЗнач> | Необязательный параметр. В случае выбора из списка, здесь можно передать значение, на которое следует изначально установить курсор при открытии формы подбора. |
Описание:
Метод ОткрытьПодбор, который доступен только в контексте Модуля формы, выполняет открытие формы для подбора значений. Используется, например, для подбора значения реквизита документа.
При открытии подбора по журналу подчиненных документов, т. е. когда первый параметр <ИмяОбъекта> имеет значение "Журнал.Подчиненные", документ владелец, по которому следует построить журнал подчиненных документов, передается после вызова метода через полученный контекст формы.
Пример:
Процедура Подбор()
ГруппаДляВыбора = ТекущийЭлемент();
Если ГруппаДляВыбора.ЭтоГруппа() = 0 Тогда
ГруппаДляВыбора = ГруппаДляВыбора.Родитель;
КонецЕсли;
ОткрытьПодбор("Справочник.Товары", "ДляПодбора", КонтПодб, 0);
// установим в форме подбора реквизит "ГруппаВыбора"
// используя полученный контекст формы подбора
КонтПодб.ГруппаВыбора.ВыборГруппы(1);
КонтПодб.ГруппаВыбора = ГруппаДляВыбора;
КонтПодб.Обновить(0);
УстановитьЗначениеВПодборе("ГруппаВыбора", ГруппаДляВыбора);
КонецПроцедуры
См. также: ОбработкаПодбора, УстановитьЗначениеВПодборе.