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

         

ИзменениеПорядкаСтрок


Установить режим изменения порядка строк в форме операции.

Синтаксис:

ИзменениеПорядкаСтрок(<Разрешить>)

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

ChangeLinesOrder

Параметры:

<Разрешить>

Необязательный параметр. Число: 1 — разрешить изменение порядка строк в операции; 0 — запретить. Если параметр не задан, то режим не меняется.

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

Режим изменения порядка строк до исполнения метода. Число: 1 — разре­шено изменение порядка строк в операции; 0 — запрещено.

Описание:

Метод ИзменениеПорядкаСтрок позволяет установить режим изменения порядка строк в форме операции.

Пример:

ИзменениеПорядкаСтрок(0);





<Измерение>


Установить значение измерения регистра.

Синтаксис:

<Измерение>

Описание:

Атрибут <Измерение> задает значение выбранного измерения регистра. В тексте программного модуля используется название конкретного измерения регистра, как он назван в конфигураторе.

Пример:

Процедура ОбработкаПроведения()

   // В регистре "ТовЗап" измерениями являются "Склад" и "Товар"

   // ресурсами являются "Количество" и "Стоимость"

   Регистр.ТовЗап.Склад = Склад;

   ВыбратьСтроки();

   Пока (ПолучитьСтроку() > 0) Цикл

      Регистр.ПривязыватьСтроку(НомерСтроки);

      Регистр.ТовЗап.Товар = Товар;

      Регистр.ТовЗап.Количество = Количество;

      Регистр.ТовЗап.Стоимость = Стоимость;

      Регистр.ТовЗап.ДвижениеРасходВыполнить();

   КонецЦикла;

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



ИзСтрокиСРазделителями


Заполнить список значениями из переданной строки.

Синтаксис:

ИзСтрокиСРазделителями(<Строка>)

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

FromSeparatedString

Параметры:

<Строка>

Строковое выражение, содержащее строки в двой­ных кавычках и числа, разделенные запятыми.

Описание:

Метод ИзСтрокиСРазделителями заполняет список значениями из пере­данной в качестве параметра строки, содержащей строки в двойных кавычках и числа, разделенные запятыми.

Пример:

Спис.ИзСтрокиСРазделителями("5, 6, 12, 68, ""ОпредПредст""");



ЭкземпляровНаСтранице


Установить количество печатаемых экземпляров на странице.

Синтаксис:

ЭкземпляровНаСтранице(<Колич>)

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

CopyesPerPage

Параметры:

<Колич>

Необязательный параметр. Числовое выражение — количество печатаемых экземпляров на странице. Может принимать значения:

1 — один экземпляр на странице;

2 — два экземпляра на странице;

0 — автоматический режим размещения двух эк­земпляров на странице исходя из размеров доку­мента.

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

Текущее заданное количество печатаемых экземпляров на странице (на мо­мент до исполнения метода).

Описание:

Метод ЭкземпляровНаСтранице позволяет установить количество печа­таемых экземпляров на странице.

Пример:

Таб.ЭкземпляровНаСтранице(2);

См. также: Опции



<ЭлементДиалога>


Объект агрегатного типа «элемент диалога».

Синтаксис:

<ЭлементДиалога>

Описание:

Значение атрибута объекта «Форма» <ЭлементДиалога> представляет со­бой ссылку на элемент диалога. Элементы диалога — это объекты специального агрегатного типа. Методы элементов диалога позволяют в программном модуле изменять их свойства, такие как Цвет, Видимость, Доступность.

В тексте программного модуля через точку после имени объекта «Форма» можно вызвать атрибут <ЭлементДиалога>, а далее через точку можно вызы­вать методы управления их свойствами. В тексте программного модуля в каче­стве названия данного атрибута подставляется идентификатор конкретного элемента диалога, существующего в диалоговом окне формы.

Пример:

// в форме диалога существуют элементы

// НазвФирмы, ИнформПоле, Название

// Поменяем свойства этих элементов диалога

Форма.НазвФирмы.Доступность(0);

Форма.ИнформПоле.Видимость(0);

Форма.Название.Цвет(255, 0, 0);

См. также: Цвет, Видимость, Доступность



ЭлементЯзыка


Краткое описание того, что делает данный ЭлементЯзыка.

Синтаксис:

ЭлементЯзыка(<Параметр1>, <Параметр2>, ...) [ДобКлючевоеСлово]

Англоязычный Синтаксис: (в случае языковых конструкций)

Keyword(<Параметр1>, <Параметр2>, ...)[AddKeyWord]

Англоязычный синоним: (в случае описания методов, функций и процедур)

Keyword

Параметры:

<Параметр1> краткое описание <Параметра1>.

<Параметр2> краткое описание <Параметра2>.

[ДобКлючевоеСлово] краткое описание ДобКлючевоеСлово.

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

Тип и краткое описание возвращаемого значения.

Описание:

Подробное описание того, что реализует ЭлементЯзыка.

Пример:

Краткое описание примера

// Исходный текст примера

См. также: Ссылки на другие методы, процедуры или функции.




ЭтоГруппа


Проверить принадлежность к группам.

Синтаксис:

ЭтоГруппа()

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

IsGroup

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

Числовое значение: 1 — если выбранный элемент справочника является группой , 0 — если выбранный элемент справочника обычный элемент.

Описание:

Метод ЭтоГруппа возвращает числовое значение 1 — если выбранный элемент справочника является группой , 0 — если выбранный элемент спра­вочника обычный элемент.

Пример:

* В данном примере мы просматриваем весь справочник "Сотрудники" и для групп сотрудников выводим в таблицу секцию "Группа", а для со­трудников выводим секцию " Элемент"

Таб = СоздатьОбъект("Таблица");

Таб.ВывестиСекцию("Отчет");

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

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

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

   Если Сотр.ЭтоГруппа() = 1 Тогда

      Таб.ВывестиСекцию("Группа");

   Иначе

      Таб.ВывестиСекцию("Элемент");

   КонецЕсли;

КонецЦикла;

См. также: ПринадлежитГруппе



ЭтоГруппа


Определяет, является ли данный счет группой.

Синтаксис:

ЭтоГруппа()

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

IsGroup

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

Число: 1 — счет является группой; 0 — счет не является группой.

Описание:

Для каждого счета при создании указывается — может ли он иметь субсчета (будет являться группой) или будет собственно счетом (не группой). Счета-группы не могут участвовать в проводках. В дальнейшем это свойство счета не изменяется.

Данная функция определяет, является счет группой (может иметь субсчета) или нет.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Если Сч.ЭтоГруппа() = 1 Тогда

   Сообщить("Найдена группа");

КонецЕсли;



ЭтоГруппа


Определяет, является ли текущее значение группироки запроса по субконто группой или нет. Имеет смысл только для субконто типа «справочник».

Синтаксис:

ЭтоГруппа()

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

IsGroup

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

Число: 1 — значение группировки по субконто является группой; 0 — зна­чение группировки по субконто не является группой.

Описание:

Данный метод позволяет определить, является ли текущее значение груп­пироки запроса по субконто группой или нет. Метод можно применять незави­симо от типа данных вида субконто, однако он имеет смысл только для субкон­то типа «справочник», а для остальных выдает 0.

Пример:

Пока БухИтоги.ПолучитьСубконто() = 1 Цикл

   Если БухИтоги.ЭтоГруппа() = 1 Тогда

      Таб.ВывестиСекцию("Группа");

   Иначе

      Таб.ВывестиСекцию("Строка");

   КонецЕсли;

КонецЦикла;



ЭтоГруппа


Возвращает флаг принадлежности группе справочника.

Синтаксис:

ЭтоГруппа(<ИмяГруппировки>)

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

IsItAGroup

Параметры:

<ИмяГруппировки>

Выражение, содержащее порядковый номер или имя группировки (см. Главу «Язык запро­сов»).

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

Число: 1 — если текущая строка выборки (временного набора данных, сформированного в результате выполнения запроса) является группой спра­вочника, 0 — если это обычный элемент справочника.

Описание:

Метод ЭтоГруппа предназначен для выделения строк временного набора данных, которые являются группой справочника.

Пример:

Пока (Запр.Группировка("Товар") = 1) И (Запр.ЭтоГруппа("Товар") = 1) Цикл

   ...

КонецЦикла;



КаталогИБ


Получить каталог базы данных.

Синтаксис:

КаталогИБ()

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

IBDir

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

Строковое значение, содержащее имя каталога базы данных.

Описание:

Функция КаталогИБ возвращает имя каталога базы данных.

Пример:

МояБД = КаталогИБ();



КаталогПользователя


Получить каталог пользователя.

Синтаксис:

КаталогПользователя()

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

UserDir

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

Строковое значение, содержащее имя рабочего каталога пользователя.

Описание:

Функция КаталогПользователя возвращает имя рабочего каталога поль­зователя, заданный пользователю в конфигураторе.

Пример:

МояДиректория = КаталогПользователя();



КаталогПрограммы


Получить каталог программы.

Синтаксис:

КаталогПрограммы()

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

BinDir

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

Строковое значение, содержащее имя каталога программы.

Описание:

Функция КаталогПрограммы возвращает имя каталога, где размещены ис­полняемые файлы системы 1С:Предприятие.

Пример:

МояДирПрог = КаталогПрограммы();



КаталогВременныхФайлов


Получить каталог временных файлов.

Синтаксис:

КаталогВременныхФайлов()

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

TempFilesDir

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

Строковое значение, содержащее имя каталога временных файлов.

Описание:

Функция КаталогВременныхФайлов возвращает имя каталога временных файлов, как он установлен в системе 1С:Предприятие. Это может быть каталог, установленный в командной строке запуска системы или, если не указан, то каталог временных файлов установленный в операционной системе.

Пример:

МояВремДир = КаталогВременныхФайлов();



Ключ


Предоставляет доступ к агрегатному типу данных типа «Ключ».

Синтаксис:

Ключ

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

Key

Описание:

Агрегатный тип данных типа «Ключ» имеет только атрибуты. Состав атри­бутов полностью повторяет атрибуты XBase-объекта за исключением того, что отсутствует атрибут «Ключ». Значения атрибутов используются XBase-объектом для вычисления выражения индекса при использовании метода НайтиПоКлючу.

Пример:

ДБФ.Ключ.FIO = ФИО;

ЗаписьНайдена = ДБФ.НайтиПоКлючу(0);



КнопкаПоУмолчанию


Задает кнопку в форме, которая будет «срабатывать» при нажатии комбинации клавиш Ctrl + Enter.

Синтаксис:

КнопкаПоУмолчанию(<ИдентификаторКнопки>)

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

DefButton

Параметры:

<ИдентификаторКнопки>

Строковое выражение — идентификатор одной из кнопок формы объекта метаданных.

Описание:

Метод КнопкаПоУмолчанию позволяет назначить одну из кнопок формы кнопкой «по умолчанию»: в этом случае нажатие комбинации клавиш Ctrl+Enter приведет к такому же результату, как и нажатие такой кнопки мы­шью.

В качестве параметра методу передается идентификатор одной из кнопок формы — так, как он указан в палитре свойств соответствующего элемента диа­лога типа «Кнопка».

Пример:

* В модуле формы документа «ПлатежноеПоручение» кнопкой по умолча­нию назначается кнопка с идентификатором " ОК".

Процедура ПриОткрытии()

   Форма.КнопкаПоУмолчанию("ОК");

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



Код


Значение реквизита Код.

Синтаксис:

Код

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

Code

Описание:

Атрибут Код предоставляет доступ к значению обязательного реквизита " Код" выбранного элемента справочника.

Пример:

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

Спр.НайтиПоКоду("29");

Ид = Спр.Код;

Спр.Код = Ид + "5";



Код


Полный код счета.

Синтаксис:

Код

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

Code

Описание:

Код счета в общем случае представляет собой символьную строку вида:

<Код счета>.<Код субсчета>.<Код субсчета> ...

Общая длина кода счета в системе 1С:Предприятие ограничена 255 симво­лами. В это значение входят: код счета первого уровня, коды субсчетов всех нижележащих уровней и разделители номеров счета и субсчетов (точка). При помощи атрибута Код можно получать и задавать код счета.

Пример:

* При показе готового табличного документа (в данном примере это отчет «Карточка счета») в заголовке окна выдается наименование отчета и код счета, по которому построен отчет.

// Формирование отчета "Карточка счета"

Табл = СоздатьОбъект("Таблица");

// ...

<команды формирования отчета и выдачи секций табличного документа>

// ...

// Показ готового отчета

Табл.Показать("Карточка счета: " + Счет.Код);



Код


Код вида расчета или группы видов расчета.

Синтаксис:

Код

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

Code

Описание:

Атрибут типа «строка».

Представляет собой строку, соответствующую идентификатору, заданному при конфигурировании.

Пример:

ВРО1 = ВидРасчета.ПоОкладу;

ВР02 = ВидРасчета.АмортизацияС_НДС;

Группа = ГруппаРасчетов.ОблагаютсяНалогом;

Сообщить(ВРО1.Код);

Сообщить(ВР02.Код);

Сообщить(Группа.Код);

См. также: Наименование



КодОшибки


Возвращает код последней ошибки.

Синтаксис:

КодОшибки()

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

ErrorCode

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

Числовое значение — код последней ошибки.

Описание:

Метод КодОшибки возвращает код завершения последней выполненной операции.

Пример:

КО = ДБФ.КодОшибки();

Возвращаемые коды ошибок:

Код ошибки

Причина ошибки

-10

Ошибка закрытия файла

-20

Ошибка создания файла

-30

Ошибка определения длины файла

-40

Ошибка установки длины файла

-50

Ошибка при попытке заблокировать файл

-60

Ошибка при открытии файла

-70

Ошибка чтения файла

-80

Ошибка удаления файла

-90

Ошибка переименования файла

-100

Ошибка позиционирования в файле

-110

Ошибка снятия блокировки с файла

-120

Ошибка записи в файл

-200

Файл не является базой данных DBF-формата

-210

Неопознанное имя поля

-220

Неопознанный тип поля

-230

Запись слишком длинная

-300

Индексный файл не содержит информации о записи

-310

Нарушение структуры индексного файла

-330

Указанное имя индекса недоступно

-340

Ошибка уникальности индекса

-400

Ожидается запятая или скобка

-410

Выражение не завершено

-422

IIF() требует параметров одинаковой длины

-425

У STR() и SUBSTR.O 2-й и 3-й параметры — константы

-430

Неверное число параметров

-440

Слишком сложное выражение

-450

Пропущена правая скобка

-460

Неверный тип подвыражения

-470

Неопознанная функция

-480

Неопознанный оператор

-490

Неопознанное значение

-500

Выражение не завершено символом двойной кавычки

-920

Недостаточно памяти



КодоваяСтраница


Установить/определить режим кодировки.

Синтаксис:

КодоваяСтраница(<Режим>)

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

SetCodePage

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 0 — Windows-кодировка, 1 — DOS-кодировка. Если па­раметр не задан, то режим кодировки не меняется (используется для определения текущего режима кодировки без его смены).

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

Текущее числовое значение режима кодировки (на момент до исполнения метода).

Описание:

Метод КодоваяСтраница позволяет установить режим кодировки для чтения и записи строковых значений в файл.

Пример:

ТекстДок = СоздатьОбъект("Текст");

ТекстДок.КодоваяСтраница(0);

ТекстДок.Открыть("catalog.txt");

ТекстДок.Показать("Редактирование Прайс-листа", "catalog.txt");



КодоваяСтраница


Установить режим кодировки.

Синтаксис:

КодоваяСтраница(<Режим>)

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

SetCodePage

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 0 — Windows-кодировка; 1 — DOS-кодировка. Если параметр не задан, то режим кодировки не меняется (используется для определения текущего режима кодировки без его смены).

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

Текущее числовое значение режима кодировки (на момент до исполнения метода).

Описание:

Метод КодоваяСтраница позволяет установить режим кодировки для чте­ния и записи значений строковых полей в файл базы данных.

Замечание. После открытия, XBase-объект всегда находится в режиме DOS-кодировки.

Пример:

ДБФ.КодоваяСтраница(1);



КодСимв


Преобразовать символ в код символа.

Синтаксис:

КодСимв(<Символ>)

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

Asс

Параметры:

<Символ>

Строковое выражение.

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

Числовое значение.

Описание:

Функция КодСимв преобразует символ в код символа. Возвращает резуль­тирующий код символа в виде числового значения.

Пример:

КодБуквы_я = КодСимв("я");



КодСубсчета


Выдает код счета без кодов счетов вышестоящих уровней.

Синтаксис:

КодСубсчета()

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

SubAccountCode

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

Строковое значение — код счета без кодов счетов вышестоящих уровней.

Описание:

При наличии в плане счетов нескольких уровней счетов-субсчетов атрибут "Код" объекта типа «Счет» содержит полный код счета с учетом всех выше­стоящих счетов через разделитель (точку). Метод КодСубсчета выдает собст­венно код даного счета без кодов счетов вышестоящих уровней.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Сообщить("Код счета " + Сч.Код); //Возвращает "76.02"

Сообщить("Код Субсчета " + Сч.КодСубсчета); //Возвращает "76"



Количественный


Признак ведения количественного учета.

Синтаксис:

Количественный

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

IsAmount

Значение:

1 — количественный учет ведется по данному счету;

0 — количественный учет не ведется по данному счету;

Описание:

Атрибут содержит признак ведения количественного учета по счету. Изме­нение данного значения из языка следует производить только в особых случаях и с учетом всех особенностей настройки учета. После изменения настроек учета система может потребовать выполнить пересчет итогов.

Пример:

Сч.Количественный = 1;



Количество


Количество выбранной проводки или корреспонденции операции.

Синтаксис:

Количество

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

Amount

Значение:

Значение типа «Число».

Описание:

Атрибут Количество служит для обращению к количеству выбранной про­водки или корреспонденции операции.

Перед обращением к атрибуту конкретной проводки эта проводка должна быть выбрана с помощью методов ВыбратьПроводки, ПолучитьПроводку или создана при помощи метода НоваяПроводка. В модулях форм «Опера­ции» и «Журнал проводок» текущая проводка определяется положением кур­сора.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Опер.ВыбратьПроводки();

Пока Опер.ПолучитьПроводку() = 1 Цикл

   Сообщить("Количество ="+0пер.Количество);

КонецЦикла;



Количество


Количество видов расчета, включенных в группу видов расчета.

Синтаксис:

Количество()

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

Count

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

Целое положительное число — количество видов расчета, входящих в груп­пу.

Описание:

Метод группы видов расчета, который позволяет определить количество ви­дов расчета, включенных в данную группу. Обычно применяется в цикле с ме­тодом ПолучитьВидРасчета.

Пример:

// модуль выполняется в контексте журнала расчетов

// текущий сотрудник Сотр = Объект;

// Для всех видов удержаний проведем расчет в

// журнале расчетов зарплаты

ЖР = СоздатьОбъект("ЖурналРасчетов.Зарплата");

ВсеУд = Группа.ВсеУдержания;

Счетчик = 1;

Пока Счетчик <= ВсеУд.Количество() Цикл

   ЖР.ВвестиРасчет(Сотр, ВсеУд.ПолучитьВидРасчета(Счетчик));

   Счетчик = Счетчик + 1;

КонецЦикла;

См. также: ПолучитьВидРасчета



КоличествоИндексов


Возвращает количество индексов в открытом индексном файле.

Синтаксис:

КоличествоИндексов()

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

IndexCount

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

Числовое значение — количество индексов в открытом индексном файле.

Описание:

Метод КоличествоИндексов возвращает количество индексов в открытом индексном файле. Может быть использован при работе с базой данных неиз­вестной заранее структуры.

Пример:

Процедура ОписИнд()

   Перем Назв;

   Перем Выр;

   Перем Уник;

   Перем Убыв;

   Перем Филт;

   СпЗнач = СоздатьОбъект("СписокЗначений");

   СпЗнач.УдалитьВсе();

   Для КП = 1 По ДБФ.КоличествоИндексов() Цикл

      ДБФ.ОписаниеИндекса(КП.Назв, Выр, Уник, Убыв, Филт);

      СпЗнач.ДобавитьЗначение("" + КП + "; " + Назв + "; " + Выр + "; " + Уник +

                              "; " + Убыв + "; " + Филт);

   КонецЦикла;

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



КоличествоЭкземпляров


Установить количество печатаемых экземпляров.

Синтаксис:

КоличествоЭкземпляров(<Колич>)

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

NumberOfCopies

Параметры:

<Колич>

Необязательный параметр. Числовое выражение — количество печатаемых экземпляров.

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

Текущее заданное количество печатаемых экземпляров (на момент до ис­полнения метода).

Описание:

Метод КоличествоЭкземпляров позволяет установить количество печа­таемых экземпляров. Если для текущей таблицы используется набор опций печати (см. Опции), то данный метод следует вызывать только после вызова метода Показать, т. к. иначе будут действовать автоматически устанавливаемые настройки печати.

Пример:

Таб.КоличествоЭкземпляров(5);

См. также: Опции



КоличествоКолонок


Устанавливает/возвращает количество колонок.

Синтаксис:

КоличествоКолонок(<КоличКолонок>)

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

ColumnCount

Параметры:

<КоличКолонок>

Необязательный параметр. Числовое выражение, которое указывает новое количество колонок. Если параметр опущен, то количество колонок не меня­ется.

Возвращаемое значение: количество колонок до вызова метода.

Описание:

Метод КоличествоКолонок устанавливает/возвращает количество коло­нок таблицы значений.

Пример:

Разм = ТаблицаТоваров.КоличествоКолонок();



КоличествоПериодов


Количество перерасчитываемых периодов для правила перерасчета.

Синтаксис:

КоличествоПериодов

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

NumberOfPeriods

Описание:

Атрибут КоличествоПериодов позволяет прочитать/установить количест­во периодов перерасчета.

Пример:

КолПер = ПравилоПерерасчета.Главное.КоличествоПериодов;



КоличествоПодчиненных


Возвращает количество «подчиненных» видов расчета.

Синтаксис:

КоличествоПодчиненных()

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

NumberOfDependents

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

Количество «подчиненных» видов расчета.

Описание:

Метод КоличествоПодчиненных возвращает количество «подчиненных» видов расчета (для которых необходимо произвести перерасчеты согласно дан­ного правила).

Пример:

Колич = ПравилоПерерасчета.Доплаты.КоличествоПодчиненных();



КоличествоПолей


Возвращает количество полей базы.

Синтаксис:

КоличествоПолей()

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

FieldCount

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

Числовое значение — количество полей базы.

Описание:

Метод КоличествоПолей возвращает количество полей базы. Может быть использован при работе с базой данных неизвестной заранее структуры.

Пример:

Процедура ОписПол()

   Перем Назв;

   Перем Тип;

   Перем Длин;

   Перем Точн;

   СпЗнач = СоздатьОбъект("СписокЗначений");

   СпЗнач.УдалитьВсе();

   Для КП = 1 По ДБФ.КоличествоПолей() Цикл

      ДБФ.ОписаниеПоля(КП, Назв, Тип, Длин, Точн);

      СпЗнач.ДобавитьЗначение("" + КП + "; " + Назв + "; " + Тип + "; " + Длин +

                              "; "+Точн);

   КонецЦикла;

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



КоличествоПроводок


Оперделяет количество проводок в операции включая и проводки и корреспонденции.

Синтаксис:

КоличествоПроводок()

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

EntriesCount

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

Целое число — количество проводок в текущей операции.

Описание:

Метод позволяет опеределить полное количество проводок и корреспонден­ции в операции.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Для Инд = 1 До Опер.КоличествоПроводок() Цикл

   Опер.ПолучитьПроводкуПоНомеру(Инд);

КонецЦикла;



КоличествоСерий


Явно устанавливает количество серий диаграммы.

Синтаксис:

КоличествоСерий(<Количество>)

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

SeriesCount

Параметры:

<Количество>

Числовое выражение, которое задает количество серий диаграммы.

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

Текущее значение количества серий (до исполнения метода).

Описание:

Метод КоличествоСерий явно устанавливает количество серий диаграм­мы. Количество серий может быть изменено и в режиме визуальной настройки. Альтернативой использования этого метода является неявное изменение коли­чества серий: в случае если в метод, одним из параметров, использующий но­мер серии, передается значение превышающее количество серий, количество серий будет неявно увеличено.

Пример:

Диагр.КоличествоСерий(3);       // установим количество серий 3



КоличествоСтрок


Определить количество строк в документе.

Синтаксис:

КоличествоСтрок()

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

LinesCnt

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

Числовое значение — количество строк в документе.

Описание:

Метод КоличествоСтрок позволяет определить количество строк в много­строчной части документа.

Пример:

Сообщить("Документ: " + Вид() + " № " + НомерДок + " от " + ДатаДок +

                    " в документе " + КоличествоСтрок() + " строк");



КоличествоСтрок


Устанавливает/возвращает количество строк в таблице значений,

Синтаксис:

КоличествоСтрок(<НовоеКоличествоСтрок>)

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

LinesCnt

Параметры:

<НовоеКоличествоСтрок>

Необязательный параметр. Новое количест­во строк в таблице значений.

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

Числовое значение — количество строк в таблице значений до вызова мето­да.

Описание:

Метод КоличествоСтрок устанавливает/возвращает количество строк в таблице значений

Пример:

Разм = ТаблицаТоваров.КоличествоСтрок();



КоличествоСтрок


Возвратить количество строк текста.

Синтаксис:

КоличествоСтрок()

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

LinesCnt

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

Количество строк в тексте.

Описание:

Метод КоличествоСтрок возвращает количество строк в тексте.

Пример:

Процедура ЗагрузкаПродукцииПоКаталогу()

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

   Если ВыбГруппа.Выбран() = 0 Тогда

      Предупреждение("Ошибка! Не выбрана группа!");

      Возврат;

   ИначеЕсли ВыбГруппа.ЭтоГруппа() = 0 Тогда

      Предупреждение("Не выбрана группа! Загрузка в корень!");

   Иначе

      Тов.ИспользоватьРодителя(ВыбГруппа);

   КонецЕсли;

   Текст = СоздатьОбъект("Текст");

   Текст.Открыть(ИмяФайла);

   Если Текст.КоличествоСтрок() = 0 Тогда

      Предупреждение("Текст пустой!");

      Возврат;

   КонецЕсли;

   Для Ном = 1 По Текст.КоличествоСтрок() Цикл

      Стр = Текст.ПолучитьСтроку(Ном);

      Поле = 0;

      Пока СтрДлина(Стр) > 0 Цикл

         Поле = Поле + 1;

         Инд = Найти(Стр, "-");

         Если Инд > 0 Тогда

            Стр1 = Сред(Стр, 2, Инд - 3);

            Стр = Сред(Стр, Инд + 1);

         Иначе

            Стр1 = Сред(Стр, 2, (СтрДлина(Стр) - 2));

            Стр = "";

         КонецЕсли;

         Если Поле = 1 Тогда

            Код = Стр1;

         ИначеЕсли Поле = 2 Тогда

            Имя = Стр1;

         КонецЕсли;

      КонецЦикла;

      Прод.НоваяГруппа();

      Сообщить(Формат(Ном, "ЧЗ") + "-загрузка: " + Формат(Код, "45") + ":" + Имя);

      Прод.Наименование = Имя;

      Прод.Код = Число(Код);

      Прод.Записать();

      Сообщить(" — Загружен!");

   КонецЦикла;

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



КоличествоСубконто


Определяет количество субконто у текущего счета.

Синтаксис:

КоличествоСубконто()

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

SubcontoCount

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

Число — количество видов субконто у текущего счета.

Описание:

Максимальное количество видов субконто, которое можно «прикрепить» к счету, устанавливается в конфигураторе при редактировании свойств планов счетов. Количество субконто, которое реально прикреплено к счету, не может превышать установленного максимального количества.

Метод КоличествоСубконто служит для определения количества видов субконто, прикрепленных к текущему счету в плане счетов.

Необходимо обратить внимание, что все виды субконто, прикрепленные к счету в плане счетов, имеют порядковые номера. Эти номера выдаются в назва­ниях колонок видов субконто в окне редактирования плана счетов; «Субкон­то1», «Субконто2» ... «Субконто6».

При задании видов субконто для счета их обязательно «выстраивать» по порядку один за другим: например, к счету могут быть прикреплены субконто таким образом, что их порядковые номера будут 1 и 2. Метод КоличествоСубконто возвращает общее количество видов субконто, прикре­пленное к счету (в данном примере — 2), а не максимальное количество воз­можных видов субконто у счета.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Для Инд = 1 По Сч.КоличествоСубконто() Цикл

   Сообщить("Субконто " + Сч.ВидСубконто(Инд));

КонецЦикла;



КоличествоТочек


Явно устанавливает количество точек диаграммы.

Синтаксис:

КоличествоТочек(<Количество>)

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

PointsCount

Параметры:

<Количество>

Числовое выражение, которое задает количество точек диаграммы.

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

Текущее значение количества точек (до исполнения метода).

Описание:

Метод КоличествоТочек явно устанавливает количество точек диаграммы. Количество точек может быть изменено и в режиме визуальной настройки. Альтернативой использования этого метода является неявное изменение коли­чества точек: в случае если в метод, одним из параметров, использующий номер точек, передается значение превышающее количество точек, количество точек будет неявно увеличено.

Пример:

Диагр.КоличествоТочек(4);      // установим количество точек 4



КоличествоВедущих


Возвращает количество «ведущих» видов расчета.

Синтаксис:

КоличествоВедущих()

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

NumberOfLeadings

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

Количество «ведущих» видов расчета.

Описание:

Метод КоличествоВедущих возвращает количество «ведущих» видов рас­чета (при вводе которых в журнал расчетов необходимо произвести перерасче­ты согласно данного правила).

Пример:

// выведем все виды расчета от которых зависят доплаты

Для Сч = 1 По ПравилоПерерасчета.Доплаты.КоличествоВедущих() Цикл

   Сообщить(ПравилоПерерасчета.Доплаты.ПолучитьВедущий(Сч));

КонецЦикла;



КоличествоЗаписей


Возвращает количество записей в базе.

Синтаксис:

КоличествоЗаписей()

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

RecCount

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

Числовое значение — количество записей в базе.

Описание:

Метод КоличествоЗаписей возвращает количество записей в базе вместе с записями, помеченными, как удаленные.

Пример:

Предупреждение("Записей — " + Строка(ДБФ.КоличествоЗаписей()));



КоличествоЗначений


Определить общее количество значений в данном виде перечисления.

Синтаксис:

КоличествоЗначений()

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

Count

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

Число общего количества значений в данном виде перечисления.

Описание:

Метод КоличествоЗначений применяется к конкретному виду перечисле­ния и позволяет определить общее количество значений в данном виде пере­числения.

Пример:

// отобразим все значения перечисления

Всего = Перечисление.ВидыТоваров.КоличествоЗначений();

Пока Ном = 1 По Всего Цикл

   Сообщить(Перечисление.ВидыТоваров.ЗначениеПоНомеру(Ном));

КонецЦикла;



КоличествоЗначений


Получить общее количество планов счетов.

Синтаксис:

КоличествоЗначений()

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

Count

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

Числовое значение: количество планов счетов конфигурации.

Описание:

Метод КоличествоЗначений применяется к атрибуту глобального контек­ста ПланыСчетов и позволяет определить общее количество планов счетов созданных в конфигурации.

Пример:

Для Инд=1 По ПланыСчетов.КоличествоЗначений() Цикл

   ПлСч = ПланыСчетов.ЗначениеПоНомеру(Инд);

КонецЦикла;



КоличествоЗначений


Получить общее количество видов субконто.

Синтаксис:

КоличествоЗначений()

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

Count

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

Числовое значение: количество видов субконто конфигурации.

Описание:

Метод КоличествоЗначений применяется к атрибуту глобального контек­ста ВидыСубконто и позволяет определить общее количество видов субконто, созданных в конфигурации.

Пример:

Для Инд = 1 По ВидыСубконто.КоличествоЗначений() Цикл

   ВидСк = ВидыСубконто.ЗначениеПоНомеру(Инд);

КонецЦикла;



КомандаСистемы


Вызывает на исполнение команду DOS.

Синтаксис:

КомандаСистемы(<СтрокаКоманды>)

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

System

Параметры:

<СтрокаКоманды>

Строковое выражение, содержащее строку коман­ды.

Описание:

Процедура КомандаСистемы вызывает на исполнение команду, как если бы она была введена в командной строке DOS. При выполнении команды за­гружается исполняемый файл как «верхняя», активная программа.

Если загружается Windows-приложение, то управление немедленно возвра­щается в систему 1С:Предприятие на следующий за оператором КомандаСистемы оператор и система продолжает выполняться как фоновая прикладная программа. Пользователь может возвратиться в запускающую про­грамму или закончив выполнение запущенной, или переключившись обратно посредством списка задач Windows.

Если в параметре <СтрокаКоманды> не содержится путь к загружаемой программе в файловой системе к программе, то поиск происходит в следующей последовательности:

- текущий системный каталог;

-             каталог Windows;

-             системный каталог Windows;

-             все каталоги, указанные в переменной PATH;

Пример:

* В данном примере запускается редактор текста notepad.exe и в него за­гружается файл textl. txt.

КомандаСистемы("notepad textl.txt");



Команды организации механизма заполнения документа методом подбора


При вводе документа, процесс заполнения реквизитов многострочной части документа может быть реализован как обычным способом, так и при помощи специального механизма — методом подбора. Этот механизм предназначен для ускорения интерактивного заполнения значений реквизитов документов типа «справочник» и «документ». Реальным примером может служить процесс за­полнения спецификации накладной путем подбора нужных товаров из спра­вочника "Товары".

В системе 1С:Предприятие для реализации подбора предназначены сле­дующие системные процедуры:

ОткрытьПодбор;

Активизировать;

АктивизироватьСтроку.

Кроме того, при обработке выбранных в подборе значений участвует сле­дующая системная предопределенная процедура:

ОбработкаПодбора.




го модуля всякого рода пояснений


Комментарий используется для размещения в исходном тексте программно­ го модуля всякого рода пояснений к работе модуля. Хорошим тоном програм­мирования считается, когда исходный текст содержит исчерпывающий коммен­тарий с описанием алгоритма. В режиме исполнения программы комментарии пропускаются. В тексте программного модуля комментарий начинается парой символов "//" и заканчивается концом строки. Это значит, что комментарий можно начинать с начала строки или записывать его после оператора на той же строке. После начала комментария писать оператор на той же строке нельзя, необходимо закончить комментарий концом строки.
Пример:
А=В; // Это – комментарий
// Это тоже комментарий

Атрибут Комментарий дает доступ


Описание корректной проводки.
Синтаксис:
Комментарий
Англоязычный синоним:
Description
Описание:
Атрибут Комментарий дает доступ к значению описания корректной про­водки.
Пример:
КП = СоздатьОбъект("КорректныеПроводки");
КП.ВыбратьКорректныеПроводки();
Пока КП.ПолучитьКорректнуюПроводку() = 1 Цикл
   Сообщить(КП.Комментарий);
КонецЦикла;

в тексте описания запроса начинается


Комментарий в тексте описания запроса начинается парой символов //и заканчивается концом строки.
Пример:
// Это — комментарий
Группировка Кат;  // Это тоже комментарий