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

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

Синтаксис:

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

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

UseOwner

Параметры:

<Владелец>

Необязательный параметр. Выражение со значением элемента справочника-владельца.

<ФлагИзменения>

Необязательный параметр. Этим флагом регулируется возможность интерактивного изменения владельца. 1 — пользователь может изменить владельца интерактивно, 0 — пользователь не может интерактивно изменить владельца. Этот параметр используется в случае использовсния данного метода для объектов типа «справочник», которые являются реквизитами формы или реквизитами диалога.

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

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

Описание:

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

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

Для объектов типа «справочник», которые являются реквизитами формы (например, в форме документа — реквизит документа типа «справочник») или реквизитами диалога (например, в форме отчета — реквизит диалога типа «справочник») метод ИспользоватьВладельца позволяет программно установить некоторое значение справочника-владельца в качестве владельца, который будет использован при интерактивном выборе значения данного реквизита.

Пример:

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

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

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

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

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

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

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

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

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

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

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

КонецЦикла;

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

Пример:

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

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

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

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

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

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

Синтаксис:

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

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

UseOwner

Параметры:

<Владелец>

Необязательный параметр. Выражение со значением элемента справочника — нового владельца. Если параметр не задан, то значение владельца не меняется.

<ФлагИзменения>

Необязательный параметр. Этим флагом регулируется возможность интерактивного изменения владельца, 1 — пользователь может изменить владельца интерактивно, 0 — пользователь не может интерактивно изменить владельца. Если параметр не задан, то значение флага не меняется.

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

Значение владельца для формы списка подчиненного справочника (до применения метода).

Описание:

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

Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему подчиненному справочнику, который доступен в локальном контексте Модуля формы списка справочника.

При добавлении нового элемента текущего справочника данный параметр также будет являться свойством нового элемента.

Пример:

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

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