Методы
Синтаксис:
Вставить(<Индекс>)
Параметры:
<Индекс> Обязательный
Тип: Число. Индекс позиции в табличной части, в которую необходимо вставить строку.
Возвращаемое значение:
Тип: Строка табличной части. Вставленная строка.
Описание:
Вставляет в табличную часть строку с указанным индексом.
Пример:
Ответы.Вставить(1);
Синтаксис:
Выгрузить()
Возвращаемое значение:
Тип; ТаблицаЗначений. Таблица значений, содержащая строки табличной части. Имена колонок таблицы значений совпадают с именами колонок табличного поля. Колонка, содержащая номер строки, выгружается в колонку с именем НомерСтроки.
Описание;
Выгружает табличную часть в таблицу значений.
Пример:
ТаблицаСостава = Состав.Выгрузить();
ВыгрузитьКолонку ( UnloadColumn )
Синтаксис:
ВыгрузитьКолонку(< Колонка>)
Параметры:
<Колонка> Обязательный
Тип- Число, Строка. Колонка, из которой нужно выгрузить значения. В качестве значения параметра может быть передан индекс колонки, имя колонки.
Возвращаемое значение:
Тип: Массив. Массив, содержащий значения колонки.
Описание:
Выгружает значения, содержащиеся в колонке табличной части в массив.
Примечание:
Значения из колонки выгружаются в порядке индексов строк в табличной части.
Пример:
Товары = Состав.ВыгрузитьКолонку("Номенклатура");
Синтаксис:
Добавить()
Возвращаемое значение:
Тип: Строка табличной части. Добавленная строка.
Описание:
Добавляет строку в конец табличной части.
Пример:
Состав.Добавить();
Синтаксис:
Загрузить (< Таблица> )
Параметры:
<Таблица> Обязательный
Тип: ТаблицаЗначений. Таблица значений, откуда загружается табличная часть. Колонки таблиц совмещаются по именам.
Описание:
Загружает табличную часть из таблицы значений. При этом все прежние строки табличной части удаляются. При загрузке значения в колонках табличной части заполняются значениями из колонок таблицы значений с совпадающими именами.
Пример:
Состав.Загрузить(ТаблицаСостава);
ЗагрузитьКолонку ( LoadColumn )
Синтаксис:
ЗагрузитьКолонку (< Массив>, <Колонка>)
Параметры:
<Массив> Обузательный
Тип: Массив. Массив значений для загрузки в колонку.
<Колонка> Обязательный
Тип: Число, Строка. Колонка, в которую будут загружены значения из массива.
В качестве значения параметра может быть передан индекс колонки, либо имя колонки.
Описание:
Загружает значения из массива в заданную колонку табличной части.
Примечание:
Значения из массива загружаются в колонку в порядке индексов.
Пример:
Состав.ЗагрузитьКолонку(Товары, "Номенклатура") ;
Индекс ( IndexOf )
Синтаксис:
Индекс(< Строка>)
Параметры:
<Строка> Обязательный
Тип: Строка табличной части- Строка табличной части, для которой необходимо получить индекс.
Возвращаемое значение:
Тип: Число. Индекс строки.
Описание:
Получает индекс стоки в табличной части.
Пример:
ИндексТекСтроки = Состав.Индекс(ЭлементыФормы.Состав.ТекущаяСтрока);
Итог (Total)
Синтаксис:
Итог (<Колонка> )
Параметры:
<Колонка> Необязательный
Тип; Число, Строка. Индекс либо имя колонки, по которой подсчитывается итог.
Возвращаемое значение:
Тип: Число.
Описание:
Суммирует значения всех строк в указанной колонке.
Примечание:
Имеет смысл для числовых значений.
Пример:
ВсегоПоДокументу = Сумма.Итог("Всего");
Количество ( Count )
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число. Количество строк табличной части.
Описание:
Позволяет получить количество строк табличной части.
Пример:
ВсегоСтрок = Состав.Количество();
Найти ( Find )
Синтаксис:
Найти(< Значение>, <Колонки>)
Параметры:
<3начение> Обязательный
Тип: Произвольный. Искомое значение.
<Колонки> Необязательный
Тип: Строка. Список имен колонок, в которых будет осуществляться поиск, разделенных запятыми.
Значение по умолчанию: Если параметр не указан или передана пустая строка, поиск осуществляется по всей таблице.
Возвращаемое значение:
Тип: Строка табличной части. Строка, которая содержит искомое значение. Если значение не найдено возвращает значение Неопределено
Описание:
Позволяет найти значение в указанных колонках табличной части. Если список колонок пуст, поиск осуществляется по всей табличной части.
Примечание:
Метод эффективно использовать для поиска уникальных значений.
Пример:
НайдСтрока = Состав.Найти(ТекТовар, "Номенклатура');
Если НайдСтрока = Неопределено Тогда
Предупреждение("Товар не найден !");
Иначе
Количество = НайдСтрока.Количество;
КонецЕсли;
НайтиСтроки ( FindRows )
Синтаксис:
НайтиСтроки (< Параметры отбора>)
Параметры:
<Параметры отбора> Обязательный
Тип: Структура. Задает условия поиска: ключ структуры определяет имя колонки, по которой будет осуществляться поиск, а значение структуры - искомое значение.
Возвращаемое значение:
Тип: Массив. Массив из строк табличной части, соответствующих заданному условию поиска.
Замечание! Массив хранит ссылки на строки табличной части, то есть при изменении строки в табличной части, значение в массиве тоже будет изменено.
Описание:
Позволяет найти строки табличной части, соответствующие заданному условию поиска.
Примечание:
Метод эффективно использовать для выборки неуникальных значений.
Пример:
ПараметрыОтбора = Новый Структура;
ПараметрыОтбора.Вставить("Номенклатура", ТекТовар);
НайдСтроки = Состав.НайтиСтроки(ПараметрыОтбора);
Очистить ( Clear )
Синтаксис:
Очистить ()
Описание:
Удаляет все строки табличной части.
Пример:
Состав.Очистить();
Свернуть ( GroupBy )
Синтаксис:
Свернуть(<Колонки группировок, <Колонки суммирования>)
Параметры:
<Колонки группировок> Обязательный
Тип: Строка. Имена колонок, разделенные запятыми, по которым необходимо группировать строки табличного поля.
<Колонки суммирования> Необязательный
Тип: Строка. Имена колонок, разделенные запятыми, по которым необходимо суммировать значения в строках табличного поля.
Описание:
Осуществляет свертку табличной части по указанным колонкам группировки. Строки, у которых совпадают значения в колонках, указанных в первом параметре, сворачиваются в одну строку. Значения этих строк, хранящиеся в колонках, указанных во втором параметре, накапливаются.
Важно! Оба списка колонок должны покрывать всю табличную часть. Списки колонок не должны пересекаться.
Пример:
Состав.Свернуть("Номенклатура", "Количество, Сумма, Всего"');
Сдвинуть ( Move )
Синтаксис:
Сдвинуть(< Строка>, <Смещение>)
Параметры:
< Строка> Обязательный
Тип: Число, Строка табличной части. Индекс строки, которую нужно сдвинуть, либо сама сдвигаемая строка.
<Смещение> Обязательный
Тип: Число. Количество строк, на которое необходимо переместить строку. Положительное значение означает, что строка будет передвинута ближе к концу табличной части (вниз), отрицательное - ближе к началу (вверх).
Описание:
Позволяет переместить строку табличной части на указанное количество позиций.
Пример:
// сдвиг 2-й строки на предыдущую позицию
Состав.Сдвинуть(1, -1);
// сдвиг 2-й строки на следующую позицию
Состав.Сдвинуть(1, 1);
Удалить ( Remove )
Синтаксис:
Удалить(< Индекс>)
Параметры:
<Индекс> Обязательный
Тип: Число, Строка табличной части. Индекс удаляемой строки в табличной части, либо сама удаляемая строка.
Описание:
Удаляет строку с указанным индексом из табличной части.
Пример:
Состав.Удалить(3);