Устанавливает владельца для подчиненного справочника
Синтаксис
Метод ИспользоватьВладельца() имеет следующий синтаксис:
справочник ИспользоватьВладельца([Владелец], [МожноИзменять = 1])
А также альтернативный англоязычный синтаксис:
reference UseOwner([Owner],[ChangeMode = 1])
Параметры
Описание параметров метода ИспользоватьВладельца():
| Имя параметра | Тип | Описание | ||||
|---|---|---|---|---|---|---|
| Владелец | Справочник | значение элемента справочника-владельца, которому подчинен данный справочник | ||||
| МожноИзменять | Число | задает возможность интерактивной смены владельца в форме выбора. Возможные значения:
Внимание! данный параметр имеет смысл только при интерактивном выборе в форме выбора
|
||||
| Жирным шрифтом выделены обязательные параметры | ||||||
Возвращаемое значение
Справочник — ссылка на текущий элемент справочника-владельца
Описание
Метод ИспользоватьВладельца() устанавливает владельца для подчиненного справочника. Возвращает значение текущего владельца (на момент до исполнения метода).
Для объектов типа Справочник, созданных функцией СоздатьОбъект(), используется для:
- организации выборки элементов справочника, подчиненных определенному владельцу. Метод следует использовать до вызова методов ВыбратьЭлементы() и ВыбратьЭлементыПоРеквизиту(), формирующих выборку;
- организации выбора элемента справочника, подчиненного определенному владельцу, в форме выбора, открываемой программно. Метод следует использовать до вызова метода Выбрать(), генерирующего форму выбора. Доступно использование параметра
МожноИзменять; - автоматической установки владельца новым элементам подчиненного справочника. Метод следует использовать до вызова метода Новый() или НоваяГруппа(), создающих новый объект данного типа;
Для реквизитов типа Справочник, размещенных в диалогах и формах, устанавливает текущего владельца, в пределах которого будет осуществляться интерактивный выбор в форме выбора при нажатии пользователем кнопки выбора (…). Доступно использование параметра МожноИзменять.
Пример использования
Пример кода с использованием метода ИспользоватьВладельца():
//выборка по владельцу Справочник = СоздатьОбъект("Справочник.ДоговорыКонтрагентов"); Справочник.ИспользоватьВладельца(ВыбКонтрагент); Справочник.ВыбратьЭлементы(); Пока Справочник.ПолучитьЭлемент() = 1 Цикл Сообщить(Справочник.ПолноеНаименование()); КонецЦикла; //выбор в подчиненном справочнике программным путем Справочник = СоздатьОбъект("Справочник.ДоговорыКонтрагентов"); Справочник.ИспользоватьВладельца(ВыбКонтрагент); Если Справочник.Выбрать("Укажите договор контрагента",) = 1 Тогда Сообщить(Справочник.ПолноеНаименование()); КонецЕсли; //выбор в подчиненном справочнике интерактивным способом ВыбДоговорКонтрагента.ИспользоватьВладельца(ВыбКонтрагент);