Описание встроенного языка системы 1С Предприятие
       

ОткрытьПодбор


Открыть форму для подбора значений.

Синтаксис:

ОткрытьПодбор(<ИмяОбъекта>, <ИмяФормы>, <КонтекстФормы>, <ФлагМножВыбора>,

              <ТекЗнач>)

Англоязычный синоним:

OpenPermanentChoice

Параметры:

<ИмяОбъекта>

Строковое выражение — имя объекта агрегатного типа, форму списка которого требуется открыть для подбора. Можно указывать справочник, жур­нал, документ (при указании документа открыва­ется форма журнала для указанного документа). Имя объекта задается в следующем виде:



  • "Справочник.ХХХХХ";

  • "Документ.ХХХХХ";

  • "Отчет.ХХХХХХ";

  • "Обработка.ХХХХХХ";

  • "Журнал.ХХХХХ" , где ХХХХХ — имя вида соответствующего объекта, как он задан в конфигураторе, например: "Справочник.Товары";

  • "Журнал.Подчиненные";

  • "ЖурналОпераций.ХХХХХ", где ХХХХХ — форма журнала пераций.

  • "ПланСчетов.ХХХХХ", где ХХХХХ — идентификатор плана счетов, как он за­дан в конфигураторе. Если ХХХХХ не за­дан, то открывается подбор из любого (всех) плана счетов.

<ИмяФормы>

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

<КонтекстФормы>

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

После исполнения данного метода система вер­нет в данную переменную контекст формы подбо­ра (см. «Передача контекста в качестве парамет­ра»). С помощью значения этого контекста можно затем произвольно манипулировать формой под­бора, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.

<ФлагМножВы6ора>

Необязательный параметр. Число: 1 — выбор не­скольких значений; 0 — выбор одного значения, после чего окно закрывается. Значение по умол­чанию: 1.

<ТекЗнач>

Необязательный параметр. В случае выбора из списка, здесь можно передать значение, на кото­рое следует изначально установить курсор при открытии формы подбора.



Описание:

Метод ОткрытьПодбор, который доступен только в контексте Модуля формы, выполняет открытие формы для подбора значений. Используется, на­пример, для подбора значения реквизита документа.

При открытии подбора по журналу подчиненных документов, т. е. когда первый параметр <ИмяОбъекта> имеет значение "Журнал.Подчиненные", документ владелец, по которому следует построить журнал подчиненных доку­ментов, передается после вызова метода через полученный контекст формы.

Пример:

Процедура Подбор()

   ГруппаДляВыбора = ТекущийЭлемент();

   Если ГруппаДляВыбора.ЭтоГруппа() = 0 Тогда

      ГруппаДляВыбора = ГруппаДляВыбора.Родитель;

   КонецЕсли;

   ОткрытьПодбор("Справочник.Товары", "ДляПодбора", КонтПодб, 0);

   // установим в форме подбора реквизит "ГруппаВыбора"

   // используя полученный контекст формы подбора

   КонтПодб.ГруппаВыбора.ВыборГруппы(1);

   КонтПодб.ГруппаВыбора = ГруппаДляВыбора;

   КонтПодб.Обновить(0);

   УстановитьЗначениеВПодборе("ГруппаВыбора", ГруппаДляВыбора);

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

См. также: ОбработкаПодбора, УстановитьЗначениеВПодборе


Содержание раздела