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

         

Методы


Вставить (Insert)

Синтаксис:

Вставить(<Индекс>)

Параметры:

<Индекс>     Обязательный

Тип: Число. Индекс вставляемой строки.

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

Тип: СтрокаТаблицыЗначений. Вставленная строка.

Описание:

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

Пример:

НоваяСтрока = ТаблицаЦен.Вставить(2);

НоваяСтрока.Товар = ТекТовар;



НоваяСтрока.Цена = ПолученнаяЦена;

ВыбратьСтроку (SelectRow)

Синтаксис:

ВыбратьСтроку(< Заголовок>, <Начальная строка> )

Параметры:

<3аголовок>     Необязательный

Тип: Строка. Заголовок диалогового окна выбора строки. Может использоваться для подсказки пользователю.

<Начальная строка>         Необязательный

Тип: СтрокаТаблицыЗначений. Указывает строку таблицы значений, на которой будет установлен курсор при открытии окна выбора.

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

Тип: СтрокаТаблицыЗначений. Выбранная строка таблицы значений. Если пользователь отказался от выбора возвращает Неопределено.

Описание:

Вызывает модальное диалоговое окно для интерактивного выбора строки из таблицы значений.

ВыгрузитьКолонку (UnloadColumn)

Синтаксис:

ВыгрузитьКолонку (< Колонка>)

Параметры:

<Колонка>     Обязательный

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

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

Тип: Массив. Массив значений, содержащихся в колонке.

Описание:

Выгружает значения колонки в массив значений.

Добавить (Add)

Синтаксис:

Добавить()

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

Тип: СтрокаТаблицыЗначений. Добавленная строка.

Описание:

Добавляет строку в конец таблицы значений.

Пример:

НоваяСтрока = ТаблицаЦен.Добавить();

НоваяСтрока.Товар = ТекТовар;

НоваяСтрока.Цена = ПолученнаяЦена;

ЗагрузитьКолонку (LoadColumn)

Синтаксис:

ЗагрузитьКолонку(< Массив>, <Колонка>)




Параметры:

<Массив>    Обязательный

Тип: Массив. Массив значений, который выступает в качестве источника данных для колонки.

<Колонка>     Обязательный

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

Описание:

Загружает колонку таблицы значений из массива значений.

ЗаполнитьЗначения (FillValues)

Синтаксис:

3аполнитьЗначения (<Значение>, <Колонки>)

Параметры:

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

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

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

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

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

Описание:

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

Пример:

ТаблицаЦен.Заполнить(Рубли, "Валюта');

Индекс (IndexOf)

Синтаксис:

Индекс(<Строка>)

Параметры:

<Строка>     Обязательный

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

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

Тип: Число. Индекс строки таблицы значений. Если строка не принадлежит данной таблице, возвращается -1.

Описание:

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

Итог (Total)

Синтаксис:

Итог(<Колонка>)

Параметры:

<Колонка>     Обязательный

Тип: Строка. Имя колонки, по которой необходимо посчитать итог.

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

Тип: Число. Сумма значений по всем строкам указанной колон­ки.

Описание:

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

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

Синтаксис:

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

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

Тип: Число. Количество строк таблицы значений.

Описание:



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

Пример:

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

Найти (Find)

Синтаксис:

Найти(<Значение>, <Колонки>)

Параметры:

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

Тип: Произвольный. Искомое значение.

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

Тип: Строка. Список имен колонок, разделенных запятыми, по которым производится поиск.

Значение по умолчанию: Если параметр не указан, или передана пустая строка, поиск осуществляется по всей таблице.

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

Тип: СтрокаТаблицыЗначений. Строка, в которой содержит­ся искомое значение. Если значение не найдено возвращается Неопределено.

Описание:

Позволяет найти значение в указанных колонках таблицы значе­ний.

Примечание:

Метод эффективно использовать для поиска уникальных значе­ний.

Пример:

НайденнаяСтрока = ТаблицаЦен.Найти(ВыбТовар, "Товар");

Если НайденнаяСтрока = Неопределено Тогда 

    Предупреждение("Товар не найден!');

Иначе

    ЦенаТовара = НайденнаяСтрока.Цена;

КонецЕсли;

НайтиСтроки (FindRows)

Синтаксис:

НайтиСтроки (< Параметры отбора> )

Параметры:

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

Тип: Структура. Задает условия поиска; ключ структуры опре­деляет имя колонки, по которой будет осуществляться поиск, а значение структуры - искомое значение.

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

Тип: Массив. Массив строк таблицы значений, соответствующих условиям поиска.

Замечание!

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

Описание:

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

Примечание:

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

Очистить (Clear)

Синтаксис:

Очистить()

Описание:

Позволяет удалить все строки таблицы значений. Структура ко­лонок остается неизменной.

Пример:



ТаблицаЦен.Очистить();

Свернуть (GroupBy)

Синтаксис:

Свернуть(< Колонки группировок , <Колонки суммирования>)

Параметры:

<Колонки группировок>     Обязательный

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

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

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

Описание:

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

Важно!

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

Пример:

ТаблицаЦен.Сверауть("Товар, Налита", "Цена");

Сдвинуть (Move)

Синтаксис:

Сдвинуть(< Строка>, <Смещение> )

Параметры:

<Строка>    Обязательный

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

<Смещение>    Обязательный

Тип: Число. Количество строк, на которое необходимо перемес­тить строку. Положительное значение означает, что строка будет передвинута ближе к концу таблицы значений (вниз), отрица­тельное - ближе к началу (вверх).

Описание:

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

Пример:

// перемещение первой строки вперед на одну позицию

ТаблицаЦен.Сдвинуть(0, 1) ;

// перемещение второй строки назад на одну позицию

ТаблицаЦен.Сдвинуть(1, -1);

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

Синтаксис:

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

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

Тип: ТаблицаЗначений.

Описание:

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

Пример:

НовТаблицаЦен = ТаблицаЦен.Скопировать();



Сортировать (Sort)

Синтаксис:

Сортировать(< Колонки>)

Параметры:

<Колонки>     Обязательный

Тип: Строка. Список имен колонок, разделенных запятыми, по которым производится сортировка таблицы. После каждого име­ни колонки через пробел может быть указано направление сорти­ровки. Направление определяется: "Убыв" ("Desc") - упорядочи­вать по убыванию; "Возр" ("Asc") - упорядочивать по возраста­нию. По умолчанию сортировка производится по возрастанию. Порядок указания имен колонок таблицы определяет порядок сортировки. Это означает, что сначала таблица сортируется по колонке, указанной первой. Затем группы строк с одинаковым значением в этой колонке сортируются по колонке, которая ука­зана второй, и так далее.

Описание:

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

Пример:

ТаблицаЦен.Сортировать("Цена Убыв, Товар Возр");

Удалить (Remove)

Синтаксис:

Удалить(< Индекс>)

Параметры:

<Индекс>     Обязательный

Тип: Число. Индекс строки, которую надо удалить.

Описание:

Удаляет из таблицы значений строку по указанному индексу.

Пример:

ТаблицаЦен.Удалить(ИндексУдаляемойСтроки);


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