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

       

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


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

Синтаксис:

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

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

UseOwner

Параметры:



<Владелец>

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

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

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

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

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

Описание:

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

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



  • Пример:

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

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

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

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

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

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

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

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

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

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

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

       КонецЦикла;

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

    Пример:

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

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

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

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

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


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