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

         

Методы


Метаданные ( Metadata )

Синтаксис:

Метаданные()

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

Тип: Объект описания негаданного. Объект описания метаданных справочника.

Описание:

Предоставляет доступ к объекту описания метаданных справоч­ника.

Пример:

МетаданныеСправочника = Выборка.Метаданные();

Сообщить("Представление справочника - " + МетаданныеСправочника.Представление());

ПолучитьОбъект ( GetObject )

Синтаксис:

ПолучитьОбъект()



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

Тип: СправочникОбъект. <Имя справочника>. Объект, предназначенный для модификации элемента.

Описание:

Позволяет получить объект для модификации и записи элемента, на котором в данный момент спозиционирована выборка.

Пример:

Объект = ВыборкаСправочника.ПолучитьОбъект();

Следующий ( Next )

Синтаксис:

Следующий()

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

Тип: Булево. Истина - если следующий элемент выбран. Ложь - если достигнут конец выборки.

Описание:

Выполняет получение следующего элемента выборки. Для обхода справочника нужно после получения выборки вызвать данный метод для позиционирования на первый элемент и далее вызы­вать до тех пор пока не будет возвращено значение Ложь.

Пример:

ВыборкаСправочника = Справочники.Валюты.Выбрать();

Пока ВыборкаСправочника.Следующй() Цикл

Сообщить("Записана валюта " + ВыборкаСправочника.Наименование);

КонецЦикла;

УровеньВВыборке ( LevellnSelection )

Синтаксис:

УровеньВВыборке()

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

Тип: Число. Уровень в выборке.

Описание:

Позволяет определить уровень элемента справочника в выборке, полученной с помощью метода ВыбратьИерархически. Уро­вень выдается начиная с 0. То есть при обходе верхнего уровня выборки уровень будет равняться 0. Выдаваемые значения зави­сят от того, с каким отбором по родителю выполнялась выборка. Если отбор по родителю не производился, то уровень в выборке будет совпадать с уровнем элемента в справочнике.

Примечание:

Для неиерархической выборки смысла не имеет.

Пример:

МПЗ = Справочники.Номенклатура;

ВыборкаМПЗ = МПЗ.ВыбратьИерархически(ВыбГруппа,);

Пока ВыборкаМПЗ.Следующий() Цикл

    Сообщить("в выборке " + ВыборкаМПЗ. Ссылка + "Уровень "+ ВыборкаНПЗ.УровеньВВыборке()) ;

    Сообщить("в справочнике " + ВыборкаМПЗ.Ссылка + "Уровень "+ ВыборкаМПЗ.Ссылка.Уровень());

КонецЦикла ;




    Исключение

        Предупреждение("Не удалось записать объект " + Объект  + ОписаниеОшибки(),60) ;

    КонецПопытки;

КонецЕсли;

ПолучитьФорму ( GetForm )

Синтаксис:

ПолучитьФорму (< Форма>, <Владелец> , <Ключ уникальности>)

Параметры:

<Форма>  Необязательный

Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания ме­таданного требуемой формы.

Значение по умолчанию: Если параметр не указан, то использует­ся основная форма, заданная в конфигураторе.

<Владелец>  Необязательный

Тип: Форма. Форма, которая будет являться владельцем откры­ваемой формы.

<Ключ уникальности>  Необязательный

Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.

Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.

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

Тип: Форма.

Описание:

Позволяет получить форму элемента справочника, на который указывает ссылка.

Пример:

Если Не ТоварСсылка.Пустая() Тогда

    ТоварСсылка.ПолучитьФорму().Открыть();

    Возврат ;

КонецЕсли;

ПринадлежитГруппе(BelongToGroup)

Синтаксис:

ПринадлежитГруппе (< Элемент>)

Параметры:

<Элемент> Обязательный

Тип: СправочникСсылка. <Имя справочника;». Группа, для которой определяется принадлежность элемента.

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

Тип: Булево. Истина - элемент подчинен группе. Ложь - элемент не подчинен группе.

Описание:

Позволяет определить подчиненность элемента справочника группе с учетом всех уровней иерархии.

Примечание:

Метод определяет подчиненность группе непосредственно на мо­мент вызова метода путем последовательного считывания всех вышестоящих элементов.



Пример:

Если ТоварСсылка. ПринадлежитГруппе(ГруппаСсылка) Тогда Сообщить("Принадлежит");

КонецЕсли;

Пустая ( IsEmpty )

Синтаксис:

Пустая ()

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

Тип: Булево. Истина, если ссылка не указывает ни на какой

элемент

Ложь, если ссылка указывает на какой-либо элемент.

Описание:

Позволяет определить, является ли ссылка пустой или нет.

Пример:

Если ТоварСсылка.Пустая() Тогда

    Предупреждение("Не выбран товар!",60);

    Возврат;

КонецЕсли;

Скопировать ( Copy )

Синтаксис:

Скопировать()

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

Тип СправочникОбъект.<Имя справочника>.  Созданный объект для записи элемента справочника.

Описание:

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

Пример:

Если Не ТоварСсылка.Пустая() Тогда

    Копия = ТоварСсылка.Скопировать();

    Копия.Записать();

КонецЕсли;

Уровень ( Level )

Синтаксис:

Уровень()

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

Тип. Число. Уровень элемента справочника.

Описание:

Позволяет определить уровень элемента справочника.

Примечание:

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

Пример:

Сообщить("Данный элемент принадлежит уровню " + СсылкаНаЭлемент.Уровень()) ;


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