Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы справочников

ИспользоватьВладельца

Установить выборку подчиненного справочника.

Синтаксис:

ИспользоватьВладельца(<Владелец>, <ФлагИзменения>)

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

UseOwner

Параметры:

<Владелец> Необязательный параметр. Выражение со значением элемента справочника-владельца.
<ФлагИзменения> Необязательный параметр. Этим флагом регулируется возможность интерактивного изменения владельца. 1 – пользователь может изменить владельца интерактивно, 0 – пользователь не может интерактивно изменить владельца. Этот параметр используется в случае использовсния данного метода для объектов типа "справочник", которые являются реквизитами формы или реквизитами диалога.

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

Значение элемента справочника-владельца для текущего подчиненного справочника (на момент до исполнения метода).

Описание:

Метод ИспользоватьВладельца может применяться к объектам типа "справочник" в двух случаях:

  • Для объектов, созданных функцией СоздатьОбъект, метод ИспользоватьВладельца устанавливает элемент справочника-владельца (которому подчинен текущий подчиненный справочник) в качестве параметра выборки. Данный метод используется до вызова метода ВыбратьЭлементы, который фактически открывает выборку. Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить только среди тех элементов текущего подчиненного справочника, для которых владельцем является заданное значение элемента справочника-владельца <Владелец>. При записи нового элемента текущего справочника данный метод также задает владельца для нового элемента.
  • Для объектов типа "справочник", которые являются реквизитами формы (например, в форме документа – реквизит документа типа "справочник") или реквизитами диалога (например, в форме отчета – реквизит диалога типа "справочник") метод ИспользоватьВладельца позволяет программно установить некоторое значение справочника-владельца в качестве владельца, который будет использован при интерактивном выборе значения данного реквизита.

Пример:

// Процедура выводит список детей сотрудника

// Справочник детей подчинен справочнику сотрудников

Процедура ВыводСпискаДетей(Сотр)

СпрД = СоздатьОбъект("Справочник.Дети");

// в качестве параметра функции ИспользоватьВладельца

// передаем параметр, переданный в процедуру

СпрД.ИспользоватьВладельца(Сотр);

Сообщить("Дети сотрудника " + Сотр.Наименование);

СпрД.ВыбратьЭлементы();

Пока СпрД.ПолучитьЭлемент() > 0 Цикл

Сообщить(СпрД.Наименование);

КонецЦикла;

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

Пример:

// В форме элемента справочника Товары есть реквизит Единица,

// который имеет тип подчиненного справочника «Единицы»

// здесь мы можем задать ему в качестве владельца текущий элемент:

Единица.ИспользоватьВладельца(ТекущийЭлемент());

См. также: ВыбратьЭлементы, ПолучитьЭлемент, СоздатьОбъект.

Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.