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

Универсальные коллекции значений


Универсальные коллекции значений предназначены для хранения временных наборов данных в течение сеанса работы пользовате­ля. Они нe являются объектами информационной базы и служат для вспомогательного сбора, группировки, анализа и обработки информации.



Граница ( Bound )


Предназначен для получения и хранения границы некоторого ин­тервала значений. Содержит граничное значение интервала, а также признак включения или исключения граничного значения в интервал.

Используется в качестве значений свойств и параметров методов других объектов, имеющих тип Граница.

Граница используется в тех случаях, когда важно указание вклю­чения или исключения граничного значения, например при полу­чении остатков и оборотов регистров накопления, срезов и значе­ний регистров сведений, для задания интервалов запросов.



Группировка результатов запроса


Исходные данные в запросе могут быть сгруппированы с помощью агрегатных функций, указанных в качестве полей в списке выборки. Это означает, что строки в результате запроса будут содержать результаты вычисления указанных агрегатных функций, рассчитанные (сгруппированные) по записям исходных таблиц.

Сами агрегатные функции указываются в списке полей выборки; в предложении СГРУППИРОВАТЬ ПО <Поля группировки> необходимо указать список полей, по которым следует произвести группировку. В запросе будут группироваться записи исходных таблиц, содержащие одинаковые значения указанных полей.

Список полей группировки содержит ссылки на поля исходных таблиц - источников запроса, указанные через запятую:

<Поля группировки>

<Разыменование поля> [, <Разыменование поля> [, ...] ]

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

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

При использовании агрегатных функций предложение СГРУППИРОВАТЬ ПО может быть и не указано совсем; при этом все результаты запроса будут сгруппированы в одну единственную строку.

Пример:

// Требуется получить статистику по продаже товаров:

// максимальную, минимальную и среднюю цены в расходных накладных.



Выбрать

    Накладная.Номенклатура,

    Среднее (Накладная.Цена) Как Среднее,

    Максимум (Накладная.Цена) Как Максимум,

    Минимум (Накладная.Цена) Как Минимум

Из

    Документ,РасходнаяНакладная.Состав Как Накладная

Сгруппировать По

    Накладная. Номенклатура

Результат запроса:

Номенклатура Среднее Максимум Минимум
Брюки детские 1 500 1 500 1 500
Рубашка «Ковбойка» 800 800 800
Джинсы женские 1 520 1 700 1 500
Свитер детский 800 800 800
Раковина Лилия 2 250 2 250 2 250
Мойдодыр «Аквариум» 3 166,666667 4 000 2 000
Смеситель Ультра 1 500 1 500 1 500
Кухонный комбайн Крупс 1 500 1 500 1 500



ХранилищеЗначения (ValueStorage)


Объект предназначен для хранения значения в специальном фор­мате. Он может быть записан в поля информационной базы, имеющие соответствующий тип. Это позволят сохранять в ин­формационной базе значения, тип которых не может быть выбран в качестве типа поля, например, Картинка.

Большинство объектов, которые имеют неизменяемое значение, также универсальные коллекции может быть преобразовано в значение ХранилищеЗначения. К значению, хранящемуся в объекте нельзя обращаться, его можно только извлечь из храни­лища.

Замечание! Не рекомендуется хранить в реквизитах типа ХранилищеЗначения ссылки на другие объекты информаци­онной базы.

Важно! В системе не поддерживается ссылочная целостность по объектам, сохраненным в информационной базе в полях типа ХранилищеЗначений. Это означает, что при попытке удаления, например, элементов справочников система не контролирует ссылки на эти элементы, сохраненные в ХранилищеЗначений.

Пример:

МояКартинка = Новый Картинка("С:\Мои рисунки\Картинка1.bmр");

ХранилищеКартинки = Новый ХранилищеЗначения(МояКартинка);

НовНоменклатура = Справочники. Номенклатура. СоздатьЭлемент() ;

НовНоменклатура.Наименование = "Диван ""Маргарита""";

НовНоменклатура.Изображение = ХранилищеКартинки;

НовНоменклатура.Записать();



Индекс XBase


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



Индексы, выражения индекса и фильтра, индексный файл


Для организации упорядочивания содержимого файла БД и по­иска в ней по значению одного или нескольких полей применяет­ся механизм индексов. Его применение можно сравнить с сорти­ровкой картотеки по определенному признаку (совокупности признаков). Однако, в отличие от картотеки, файл БД может иметь сразу несколько индексов, и, соответственно, являться упо­рядоченным одновременно по нескольким признакам. Каждый индекс имеет наименование, признак уникальности, выражение индекса и фильтр. Наименование индекса используется для иден­тификации индекса. Выражение индекса и фильтр представляют собой написанные на специальном языке выражения, вычисление значения которых для каждой записи позволяет определить ее место при упорядочивании и необходимость помещения ее в упо­рядоченный список (индекс может содержать упоминание не обо всех записях таблицы, а только об удовлетворяющих выражению фильтра). Уникальный индекс (имеющий установленным при­знак уникальности) позволяет иметь в индексе ссылки на записи только с различным значением индексного выражения.

Индексы хранятся в индексном файле. Индексный файл может содержать информацию более чем об одном индексе.



Индикатор (Progress Bar)


Индикатор предназначен для представления текущего состояния некоторого изменяющегося числового значения. Например, может применяться для наглядного представления выполнения процесса перебора строк таблицы значений или элементов массива. Для индикатора не предусмотрено формирование каких-либо событий, он также не может изменять связанные с ним данные.



Использование номеров и индексов


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

При обращении к элементам коллекций используется понятие Индекс. Индексирование элементов коллекций начинается с 0.



Использование процедур и функций


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

Для этих целей используют указание препроцессору.

Для выполнения на сервере:

#Если Сервер Тогда

...

#КонецЕсли

Для выполнения на клиентском месте:

#Если Клиент Тогда

...

#КонецЕсли

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»



Использование слова ПЕРВЫЕ


В некоторых случаях необходимо вывести в отчет ограниченное количество строк. Для этого в описании запроса следует указать ключевое слово ПЕРВЫЕ, и после него - требуемое количество строк.

Пример:

// Необходимо отобрать пять самых дорогих товаров.

// Выборка должна осуществляться в порядке убывания цены товара.

Выбрать Первые 5

Справочник.Номенклатура.Наименование,

Справочник.Номенклатура.ЗакупочнаяЦена

Упорядочить По Справочник.Номенклатура.ЗахупочнаяЦена Убыв

Результат запроса:

Наименование ЗакупочнаяЦена
Кухонный комбайн Крупс 15000
Джинсы женские 1500
Рубашка «Ковбойка» 1100
Брюки детские 800
Смеситель «Ультра» 460



Использование слова РАЗЛИЧНЫЕ


Во многих ситуациях желательно, чтобы одинаковые строки в отчете не повторялись.

Пример:

// Необходимо узнать, каким вообще контрагентам

// отгружался товар за период.

Выбрать Документ.РасходнаяНакладная.Контрагент

Результат запроса:

Контрагент
Павильон 45 на оптовом рынке
Ярмарка одежды
Павильон 45 на оптовом рынке
Торговый дом «Буденовский»
Ярмарка одежды
Ярмарка одежды

Видно, что в результате запроса много повторяющихся строк, что снижает его наглядность. Чтобы избежать повторений, в описа­нии запроса следует указать ключевое слово РАЗЛИЧНЫЕ.

Пример:

Выбрать Различные Документ.РасходнаяНакладная.Контрагент

Результат запроса:

Контрагент
Павильон 45 на оптовом рынке
Ярмарка одежды
Торговый дом «Буденовский»



Источники данных (таблицы) запросов


В качестве источников данных языка запросов выступают табли­цы базы данных. Таблицы подразделяются на два основных клас­са: реальные и виртуальные.

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

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

Для каждой виртуальной таблицы определяется имя, которое ис­пользуется в запросах для идентификации таблицы. Имя таблицы может быть задано на английском и русском языках. Например, Справочник.Товары. Имена таблиц и полей не могут совпа­дать с ключевыми словами языка запросов.

Отдельный подкласс таблиц образуют так называемые объектные таблицы. В качестве объектной таблицы обязательно выступает реальная таблица базы данных. Смысловое отличие объектных таблиц от прочих следует из названия - объектные таблицы предназначены для хранения состояния объектов системы 1C Предприятие, таких как справочники, документы и т. п. Каж­дой объектной таблице соответствует тип объектов системы 1C Предприятие. Например,

объектам

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




Объектные таблицы могут быть также иерархическими Для ие­рархических таблиц определяется специально выделенное поле Родитель, содержащее ссылку на запись, которой в соответст­вии с иерархией подчиняется текущая запись.

В качестве поля таблицы может фигурировать:

• поле виртуальной или реальной таблицы;

• вложенная таблица.

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

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


Итоги по иерархии


Есть возможность рассчитать итоги по иерархии. Для этого после имени поля, для которого вычисляются итоги необходимо указать ключевое слово ИЕРАРХИЯ. В результате будут рассчитаны итоги по контрольным точкам и итоги по иерархии для контрольных точек.

Пример:

ВЫБРАТЬ

Док.Товар,

    Док.Количество,

    Док.Ссылка.Номер,

    Док,Ссылка.Получатель

ИЗ

    Документ.РасхНакл.Состав Док

УПОРЯДОЧИТЬ ПО

    Док.Товар

ИТОГИ

    СУММА(Количество)

ПО

    Док.Товар ИЕРАРХИЯ

Результат запроса:

Товар Количество Номер Получатель
Сантехника 104    
Кран 84    
Кран 10 РНк-1 Урюпинскторг
Кран 8 РНк-3 Маг. "Хозяин"
Кран 44 РНк-4 Маг. "Гигант"
Кран 22 РНк-5 Урюпинскторг
Вантус 20    
Вантус 5 РНк-1 Урюпинскторг
Вантус 1 РНк-3 Маг. "Хозяин"
Вантус 14 РНк-4 Маг. "Гигант"
Мебель 134    
Стол 26    
Стол 1 РНк-1 Урюнинскторг
Стол 15 РНк-2 Маг. "Мебель"
Стол 10 РНк-4 Маг. "Гигант"
Стул 108    
Стул 55 РНк-2 Маг. "Мебель"
Стул 5 РНк-3 Маг. "Хозяин"
Стул 32 РНк-4 Маг. "Гигант"
Стул 16 РНк-5 Урюпинскторг

При необходимости можно рассчитать итоги только значений по иерархии, без расчета итогов в контрольных точках. Для этого перед ключевым словом ИЕРАРХИЯ нужно указать ключевое слово ТОЛЬКО.

Пример:

ВЫБРАТЬ

    Док.Товар, Док.Количество, Док.Ссылка.Номер, Док.Ссылка.Получатель

ИЗ

    Документ.РасхНакл.Состав Док

УПОРЯДОЧИТЬ ПО

    Док.Товар

ИТОГИ

    СУММА(Количество)

ПО Док.Товар ТОЛЬКО ИЕРАРХИЯ

Результат запроса:

Товар Количество Номер Получатель
Сантехника 104    
Кран 10 РНк-1 Урюпинскторг
Кран 8 РНк-3 Маг. "Хозяин"
Кран 44 РНк-4 Маг. "Гигант"
Кран 22 РНк-5 Урюпинскторг
Вантус 5 РНк-1 Урюпинскторг
Вантус 1 РНк-3 Маг. "Хозяин"
Вантус 14 РНк-4 Маг. "Гигант"
Мебель 134    
Стол 1 РНк-1 Урюнинскторг
Стол 15 РНк-2 Маг. "Мебель"
Стол 10 РНк-4 Маг. "Гигант"
Стул 55 РНк-2 Маг. "Мебель"
Стул 5 РНк-3 Маг. "Хозяин"
Стул 32 РНк-4 Маг. "Гигант"
Стул 16 РНк-5 Урюпинскторг



Язык запросов


Как было описано выше, для выполнения запроса необходимо составить текст запроса. Текст запроса - это инструкция, в соот­ветствии с которой должен быть выполнен запрос. В тексте за­проса описывается, какие таблицы информационной базы исполь­зуются в качестве источников данных запроса, поля таблиц, кото­рые требуется обрабатывать в запросе, правила группировки, сор­тировки результатов и т д.

Инструкция составляется на специальном языке - языке запросов, и состоит из отдельных частей - секций, предложений, слов, функций и комментариев. Далее в этой главе рассматриваются назначение и способы использования всех конструкций языка запросов.



Элемент отбора


Используется для управления параметрами отбора по одному элементу отбора.



Элемент управления интерфейсом


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

Пример:

Интерфейсы.Основной.Видимость = Истина;



ЭлементЯзыка (АнглоязычныйСиноним)


Синтаксис:

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

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

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

Англоязычный синоним: (когда необходим)

Keyword

Параметры: 

<Параметр 1>

Обязательный / Необязательный

Описание параметра.

<Параметр 2>

Обязательный / Необязательный

Описание параметра.

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

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

Описание: 

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

Примечание: 

Примечание к изложенному описанию.

Пример: 

// текст примера с комментариями

См.также:

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

1С: Предприятие 8.0 »»»»»»»»»»



ЭлементСпискаЗначений (ValueListItem)


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

Пример:

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

ТипыЦен = Новый СписокЗначений;

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

ТекНаценка = ВыборкаТиповЦен.Наценка;

    Если ТекНаценка > 10 Тогда

        ТипыЦен.Добавить(ВыборкаТиповЦен.Ссылка, ТекНаценка);

    КонецЕсли;

КонецЕсли;

Выбор = ТипыЦен.ВыбратьЗначение("Укажите требуемую наценку.");

Если Выбор <> Неопределено Тогда

    ТипЦен = Выбор.Значение;

КонецЕсли;



Элементы управления


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

Элементы управления могут быть связаны с различными типами данных. При этом многие действия, связанные с обработкой со­бытий элементов управления,  выполняются механизмами 1С:Предприятия автоматически: например, открытие формы спи­ска справочника при нажатии кнопки выбора у поля ввода и по­следующая подстановка выбранного элемента в него может осу­ществляться без использования каких-либо команд встроенного языка. Однако всегда есть возможность изменить стандартную обработку события, либо добавить собственную, используя про­цедуры-обработчики.

В зависимости от типа данных, связанных с элементом управле­ния, он имеет различный набор свойств, методов, событий. В дан­ном разделе описываются общие свойства, методы, события эле­ментов управления- дополнительные свойства, методы, события, зависящие от типа данных, и называемые расширениями элемен­тов управления, приведены в описании соответствующих объек­тов.



ЭлементыФормы (Controls)


Используется для доступа к элементам управления, расположен­ным на форме.

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

См. также:

Форма, свойство ЭлементыФормы.



Картинка (Picture)


Объект представляет собой картинку из коллекции картинок, пустую картинку, либо загруженную из внешнего файла.



КлючИЗначение (KeyAndValue)


Объект является элементом коллекции Структура, представляя собой пару из ключа и соответствующего ключу значения.



КлючИЗначение (KeyAndValue)


Объект является элементом коллекции Соответствие, пред­ставляя собой пару из ключа и соответствующего ключу значе­ния.



Кнопка (Button)


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



КнопкаКоманднойПанели (CommandBarButton)


Используется для доступа к свойствам кнопки командной панели.

Пример:

КП = ЭлементыФормы.КоманднаяПанель;

НовоеДействие = Новый Действие("ДобавочноеДействие');

ТипКнопки = ТипКнопкиИнтерфейса.Действие;

НоваяКнопка = КП.Кнопки.Добавить(ТипКнопки,,КнопкаНажатие);

НоваяКнопка.Имя = "НоваяКнопка";

НоваяКнопка.Отображение = ОтображениеКнопкиИнтерфейса.Картинка;

НоваяКнопка.Картинка = БиблиотекаКартинок.Лупа;

НоваяКнопка.Подсказка = "Вызов ""Добавочное действие""";

НоваяКнопка.Пояснение = "Кнопка, добавленная средствами языка";

// Сочетание клавиш Alt+Ctrl+F3

СочетаниеКл = Новый СочетаниеКлавиш(Клавиша.F3, Истина, Истина);

НоваяКнопка.СочетаниеКлавиш = СочетаниеКл;



КнопкиКоманднойПанели (CommandBarButtons)


Используется для доступа к свойствам и методам коллекции кно­пок командной панели.

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

Пример:

КП = ЭлементыФормы.КоманднаяПанель1;

КнопкаНажатие = Новый Действие("НоваяНажатие");

ТипКнопки = ТипКнопкиКоманднойПанели.Действие;

НоваяКнопка = КП.Кнопки.Добавить(ТипКнопки,,,КнопкаНажатие );

НоваяКнопка.Имя = "НовКн";

НоваяКнопка.Картинка = БиблиотекаКартинок.Параметры;

НоваяКнопка.Отображение = ОтображениеКнопкиКоманднойПанели.Авто;



Коллекция индексов XBase


Представляет собой коллекцию индексов таблицы базы данных.

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа Индекс XBase. Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции



Коллекция объектов описания метаданных


Объект представляет собой коллекцию объектов описания мета­данных определенного типа.

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



Коллекция полей XBase


Представляет собой коллекцию полей таблицы базы данных фор­мата DBF.

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



Коллекция страниц панели


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

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



КоллекцияКолонокДереваЗначений


Объект представляет собой коллекцию колонок дерева значе­ний. Доступ к объекту осуществляется через свойство Колонки

дерева значений.

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа КолонкаДереваЗначений. Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции. Возможно обра­щение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс элемента.



КоллекцияКолонокРезультатаЗапроса (QueryResultColumnsCollection)


Объект представляет собой коллекцию колонок результата запро­са.

Данный объект является коллекцией значений. В качестве эле­мента

коллекции

выступает значение типа КолонкаРезультатаЗапроса. Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции. Возможно обращение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс колонки



КоллекцияКолонокТаблицыЗначений (ValueTableColumnCollection)


Объект представляет собой коллекцию колонок таблицы значе­ний. Доступ к объекту осуществляется через свойство

Колонки таблицы значений.

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа КолонкаТаблицыЗначений. Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции.. Возможно обра­щение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс элемента.



КоллекцияОбластейТабличногоДокумента (TableDocumentAreasCollection)


Представляет собой коллекцию областей табличного документа, включая именованные рисунки.

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа ОбластьЯчеекТабличногоДокумента или РисунокТабличногоДокумента. Для объекта доступен об­ход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции. Возможно обращение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс элемента.



КоллекцияРисунковТабличногоДокумента (TableDocumentDrawingsCollection)


Представляет собой коллекцию рисунков, вставленных в таблич­ный документ.

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа РисунокТабличногоДокумента. Возможно обращение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс рисунка.



КоллекцияСтрокДереваЗначений (ValueTreeRowCollection)


Представляет собой коллекцию строк определенного уровня де­рева значений (подчиненных какой-либо строке дерева, либо верхнего уровня).

Данный объект является коллекцией значений. В качестве эле­мента коллекции выступает значение типа СтрокаДереваЗначений. Для объекта доступен обход кол­лекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции. Возможно обра­щение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс строки.



Колонка табличного поля


Используется для доступа к колонке табличного поля.



КолонкаРезультатаЗапроса (Query ResultColumn)


Объект представляет собой колонку результата запроса.



КолонкаТаблицыЗначений (ValueTableColumn)


Объект предоставляет собой отдельную колонку таблицы значе­ний. Доступ к объекту осуществляется через свойства коллекции колонок таблицы значений.



Колонки (Columns)


Представляет собой коллекцию колонок табличного поля.

Данный объект является коллекцией значений. В качестве эле­мента

коллекции выступает

значение типа Колонка табличного поля. Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При об­ходе выбираются элементы коллекции. Возможно обращение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс колонки.

См. также:

ТабличноеПоле, свойство Колонки.



КолонтитулТабличногоДокумента (TableDocumentHeaderFooter)


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

См. также:

ТабличныйДокумент, свойство ВерхнийКолонтитул. ТабличныйДокумент, свойство НижнийКолонтитул.

Свойства ВертикальноеПоложение (VerticalAlignment)

Использование:

Чтение и запись.

Описание:

Тип: ВертикальноеПоложение. Содержит способ выравнива­ния текста колонтитула по вертикали.

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

Выводить (Enabled)

Использование:

Чтение и запись.

Описание:

Тип: Булево. Содержит признак вывода колонтитула на печать.

НачальнаяСтраница (StartPage)

Использование:

Чтение и запись.

Описание:

Тип: Число. Содержит номер страницы, начиная с которой будет выводиться колонтитул.

ТекстВЦентре (CenterText)

Использование:

Чтение и запись.

Описание:

Тип: Строка. Содержит текст в центре колонтитула.

См. также:

КолонтитулТабличногоДокумента, свойство ТекстСлева.

ТекстСлева (LeftText)

Использование:

Чтение и запись.

Описание:

Тип: Строка. Содержит текст в левой части колонтитула. В тек­сте колонтитула можно использовать следующие управляющие конструкции:

• [&НомерСраницы] ([&PageNumber]) - при печати в данном месте будет выведен номер страницы,

• [&СтраницВсего] ([&PagesTotal]) - при печати в данном мес­те будет выведено общее количество страниц,

• [&Дата] ([&Date]) - при печати в данном месте будет выведе­на текущая дата,

• [&Время] ([&Time]) - при печати в данном месте будет выве­дено текущее время.

ТекстСправа (RightText)

Использование:

Чтение и запись.

Описание:

Тип: Строка. Содержит текст в правой части колонтитула.

См. также:

КолонтитулТабличногоДокумента, свойство ТекстСлева.

Шрифт (Font)

Использование:

Чтение и запись.

Описание:

Тип: Шрифт. Содержит шрифт колонтитула.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»



Командная панель


Элемент управления "Командная панель" (панель инструментов) предназначен для размещения в форме набора команд, с помощью которых производится управление информацией, размещенной в форме. Командная панель представляет собой древовидную структуру кнопок командной панели. Нажатие мышью на любую из кнопок вызывает немедленное выполнение связанной с этой кнопкой команды.



КоманднаяПанель (CommandBar)


Используется для доступа к свойствам командной панели в це­лом.

Пример:

ОстаткиМПЗ = РегистрыНакопления.УчетНоменклатуры;

Форма = ОстаткиМПЗ.ПолучитьФормуСписка();

КП = Форма.ЭлементыФормы.КоманднаяПанель;

НоваяРамка = Новый Рамка(ТипРамкиЭлементаУправления.Выпуклая);

КП.Рамка = Новая.Рамка;

КП.ЦветФона = WebЦвета.ГолубойСКраснымОттенком;

КП.Подсказка = "Выводится при наведении курсора на рамку панели";

Форма.Открыть();



Комментарии в языке запросов


Текст запроса может включать комментарии. Комментарием счи­тается часть строки, начинающаяся с последовательности симво­лов // и продолжающаяся до конца строки:

// Это комментарий.

При выполнении запроса комментарии игнорируются.



КонстантаМенеджер.<Имя константы> ( ConstantManager )


Предназначен для получения (чтения) и установки (записи) зна­чения константы.



Константы


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

В программных модулях для общих действий над заданными в конфигураторе константами (получение формы для управления константами, создание набора констант) служит объект КонстантыМенеджер. Для одновременного изменения значе­ний определенной группы констант следует пользоваться объек­том КонстантыНабор. Для чтения и записи значения опреде­ленной константы    можно   обращаться   к    объекту КонстантаМенеджер.

Пример:

// Получение значения константы Директор = Константы.Директор.Получить();

// Запись значения Константы.Директор.Установить("Иванов Петр Сидорович");

//Работа с набором констант НаборКонстант = Константы.СоздатьНабор("Директор,Бухгалтер") ;

НаборКонстант.Прочитать() ;

Если ПустаяСтрока(НаборКонстант.Директор) Тогда

    НаборКонстант.Директор = "Иванов Сидор Петрович";

КонецЕсли ;

Если ПустаяСтрока(НаборКонстант.Бухгалтер) Тогда

    НаборКонстант.Бухгалтер = "Сидоров Петр Иванович";

КонецЕсли;

НаборКонстант.Записать() ;



Константы и параметры в языке запросов


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

ИСТИНА |

ЛОЖЬ |

<Литерал типа ЧИСЛО> |

<Литерал типа СТРОКА> |

<Литерал типа ДАТА> |

<Имя параметра>

<Литерал типа ЧИСЛО>

<Целое число> [.<Целое число>]

<Литерал типа СТРОКА>

<Последовательность символов>

<Литерал типа ДАТА>

ДАТАВРЕМЯ ( <Целое число>, <Целое число>, <Целое число>[, <Целое число>, <Целое число>, <Целое число>] )

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

Значения типа дата задаются с помощью ключевого слова ДАТАВРЕМЯ, после которого в скобках последовательно указы­ваются год, месяц, день, час, минута, секунда. Последние три ука­зывать необязательно.

В запрос могут передаваться параметры (см. описание объекта Запрос). Значения параметров могут использоваться в выраже­ниях языка запросов, для этого необходимо указать символ & и после него <Имя параметра>.



КонстантыМенеджер ( ConstantsManager )


Применяется в виде свойства Константы глобального контек­ста для предоставления доступа к константам.

Данный объект является коллекцией значений. В качестве эле­мента      коллекции      выступает      значение      типа КонстантаМенеджер. <Имя константы;». Для объекта дос­тупен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются КонстантаМенеджер

Пример:

Константы.ПолучитьФорму().ОткрытьМодально();



КонстантыНабор ( ConstantsSet)


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

Пример:

НаборКонстант = Константы.СоздатьНабор ("Директор,Бухгалтер");

НаборКонстант.Прочитать() ;

Если ПустаяСтрока(НаборКонстант.Директор) Тогда

НаборКонстант.Директор = "Иванов Сидор Петрович";

КонецЕсли;

Если ПустаяСтрока(НаборКонстант.Бухгалтер) Тогда

    НаборКонстант.Бухгалтер = "Сидоров Петр Иванович";

КонецЕсли;

НаборКонстант.Записать() ;



Конструкторы


Основной

Синтаксис:

Новый Хранилище3начения(< Значение>)

<3начение>            Обязательный .

Тип: Произвольный. Значение, которое должно быть помещено в хранилище.

Описание:

Создает новый объект и помещает в него заданное значение.