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