0

Справочник
Метод ИспользоватьВладельца()

Устанавливает владельца для подчиненного справочника

Синтаксис

Метод ИспользоватьВладельца() имеет следующий синтаксис:

справочник ИспользоватьВладельца([Владелец], [МожноИзменять = 1])

А также альтернативный англоязычный синтаксис:

reference UseOwner([Owner],[ChangeMode = 1])

Параметры

Описание параметров метода ИспользоватьВладельца():

Имя параметра Тип Описание
Владелец Справочник значение элемента справочника-владельца, которому подчинен данный справочник
МожноИзменять Число задает возможность интерактивной смены владельца в форме выбора. Возможные значения:

1 — пользователь может изменить владельца интерактивно (значение по умолчанию)
0 — пользователь не может изменить установленного владельца
Внимание! данный параметр имеет смысл только при интерактивном выборе в форме выбора
Жирным шрифтом выделены обязательные параметры

Возвращаемое значение

Справочник — ссылка на текущий элемент справочника-владельца

Описание

Метод ИспользоватьВладельца() устанавливает владельца для подчиненного справочника. Возвращает значение текущего владельца (на момент до исполнения метода).

Для объектов типа Справочник, созданных функцией СоздатьОбъект(), используется для:

  • организации выборки элементов справочника, подчиненных определенному владельцу. Метод следует использовать до вызова методов ВыбратьЭлементы() и ВыбратьЭлементыПоРеквизиту(), формирующих выборку;
  • организации выбора элемента справочника, подчиненного определенному владельцу, в форме выбора, открываемой программно. Метод следует использовать до вызова метода Выбрать(), генерирующего форму выбора. Доступно использование параметра МожноИзменять;
  • автоматической установки владельца новым элементам подчиненного справочника. Метод следует использовать до вызова метода Новый() или НоваяГруппа(), создающих новый объект данного типа;

Для реквизитов типа Справочник, размещенных в диалогах и формах, устанавливает текущего владельца, в пределах которого будет осуществляться интерактивный выбор в форме выбора при нажатии пользователем кнопки выбора (…). Доступно использование параметра МожноИзменять.

Пример использования

Пример кода с использованием метода ИспользоватьВладельца():

//выборка по владельцу
Справочник = СоздатьОбъект("Справочник.ДоговорыКонтрагентов");
Справочник.ИспользоватьВладельца(ВыбКонтрагент);
Справочник.ВыбратьЭлементы();
Пока Справочник.ПолучитьЭлемент() = 1 Цикл
	Сообщить(Справочник.ПолноеНаименование());
КонецЦикла;

//выбор в подчиненном справочнике программным путем
Справочник = СоздатьОбъект("Справочник.ДоговорыКонтрагентов");
Справочник.ИспользоватьВладельца(ВыбКонтрагент);
Если Справочник.Выбрать("Укажите договор контрагента",) = 1 Тогда
	Сообщить(Справочник.ПолноеНаименование());
КонецЕсли;	
            
//выбор в подчиненном справочнике интерактивным способом
ВыбДоговорКонтрагента.ИспользоватьВладельца(ВыбКонтрагент);

Читайте также:

  1. Метод Справочник.ИспользоватьРодителя()

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *