Методы
Синтаксис:
Метаданные()
Возвращаемое значение:
Тип: Объект описания негаданного. Объект описания метаданных справочника.
Описание:
Предоставляет доступ к объекту описания метаданных справочника.
Пример:
МетаданныеСправочника = Выборка.Метаданные();
Сообщить("Представление справочника - " + МетаданныеСправочника.Представление());
Синтаксис:
ПолучитьОбъект()
Возвращаемое значение:
Тип: СправочникОбъект. <Имя справочника>. Объект, предназначенный для модификации элемента.
Описание:
Позволяет получить объект для модификации и записи элемента, на котором в данный момент спозиционирована выборка.
Пример:
Объект = ВыборкаСправочника.ПолучитьОбъект();
Синтаксис:
Следующий()
Возвращаемое значение:
Тип: Булево. Истина - если следующий элемент выбран. Ложь - если достигнут конец выборки.
Описание:
Выполняет получение следующего элемента выборки. Для обхода справочника нужно после получения выборки вызвать данный метод для позиционирования на первый элемент и далее вызывать до тех пор пока не будет возвращено значение Ложь.
Пример:
ВыборкаСправочника = Справочники.Валюты.Выбрать();
Пока ВыборкаСправочника.Следующй() Цикл
Сообщить("Записана валюта " + ВыборкаСправочника.Наименование);
КонецЦикла;
УровеньВВыборке ( LevellnSelection )
Синтаксис:
УровеньВВыборке()
Возвращаемое значение:
Тип: Число. Уровень в выборке.
Описание:
Позволяет определить уровень элемента справочника в выборке, полученной с помощью метода ВыбратьИерархически. Уровень выдается начиная с 0. То есть при обходе верхнего уровня выборки уровень будет равняться 0. Выдаваемые значения зависят от того, с каким отбором по родителю выполнялась выборка. Если отбор по родителю не производился, то уровень в выборке будет совпадать с уровнем элемента в справочнике.
Примечание:
Для неиерархической выборки смысла не имеет.
Пример:
МПЗ = Справочники.Номенклатура;
ВыборкаМПЗ = МПЗ.ВыбратьИерархически(ВыбГруппа,);
Пока ВыборкаМПЗ.Следующий() Цикл
Сообщить("в выборке " + ВыборкаМПЗ. Ссылка + "Уровень "+ ВыборкаНПЗ.УровеньВВыборке()) ;
Сообщить("в справочнике " + ВыборкаМПЗ.Ссылка + "Уровень "+ ВыборкаМПЗ.Ссылка.Уровень());
КонецЦикла ;
Исключение
Предупреждение("Не удалось записать объект " + Объект + ОписаниеОшибки(),60) ;
КонецПопытки;
КонецЕсли;
ПолучитьФорму ( GetForm )
Синтаксис:
ПолучитьФорму (< Форма>, <Владелец> , <Ключ уникальности>)
Параметры:
<Форма> Необязательный
Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания метаданного требуемой формы.
Значение по умолчанию: Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип: Форма.
Описание:
Позволяет получить форму элемента справочника, на который указывает ссылка.
Пример:
Если Не ТоварСсылка.Пустая() Тогда
ТоварСсылка.ПолучитьФорму().Открыть();
Возврат ;
КонецЕсли;
ПринадлежитГруппе(BelongToGroup)
Синтаксис:
ПринадлежитГруппе (< Элемент>)
Параметры:
<Элемент> Обязательный
Тип: СправочникСсылка. <Имя справочника;». Группа, для которой определяется принадлежность элемента.
Возвращаемое значение:
Тип: Булево. Истина - элемент подчинен группе. Ложь - элемент не подчинен группе.
Описание:
Позволяет определить подчиненность элемента справочника группе с учетом всех уровней иерархии.
Примечание:
Метод определяет подчиненность группе непосредственно на момент вызова метода путем последовательного считывания всех вышестоящих элементов.
Пример:
Если ТоварСсылка. ПринадлежитГруппе(ГруппаСсылка) Тогда Сообщить("Принадлежит");
КонецЕсли;
Пустая ( IsEmpty )
Синтаксис:
Пустая ()
Возвращаемое значение:
Тип: Булево. Истина, если ссылка не указывает ни на какой
элемент
Ложь, если ссылка указывает на какой-либо элемент.
Описание:
Позволяет определить, является ли ссылка пустой или нет.
Пример:
Если ТоварСсылка.Пустая() Тогда
Предупреждение("Не выбран товар!",60);
Возврат;
КонецЕсли;
Скопировать ( Copy )
Синтаксис:
Скопировать()
Возвращаемое значение:
Тип СправочникОбъект.<Имя справочника>. Созданный объект для записи элемента справочника.
Описание:
Позволяет создать новый элемент справочника копированием существующего.
Пример:
Если Не ТоварСсылка.Пустая() Тогда
Копия = ТоварСсылка.Скопировать();
Копия.Записать();
КонецЕсли;
Уровень ( Level )
Синтаксис:
Уровень()
Возвращаемое значение:
Тип. Число. Уровень элемента справочника.
Описание:
Позволяет определить уровень элемента справочника.
Примечание:
Имеет смысл только для многоуровневых справочников. Следует учитывать, что уровень элемента может меняться, например, при переносе в другую группу (смене родителя). Для элемента, не имеющего родителей уровень будет равняться 0.
Пример:
Сообщить("Данный элемент принадлежит уровню " + СсылкаНаЭлемент.Уровень()) ;