ТаблицаЗначений / ValueTable
Объект для работы с данными в табличном виде. Представляет из себя коллекцию строк с заранее заданной структурой.
Свойства
Колонки / Columns
Доступ: Чтение
Тип значения: КоллекцияКолонокТаблицыЗначений
Коллекция колонок
Индексы / Indexes
Доступ: Чтение
Тип значения: ИндексыКоллекции
Коллекция индексов
Методы
Количество / Count()
Количество строк в Таблице значений
Возвращаемое значение
Число
Добавить / Add()
Добавляет строку в конец Таблицы значений
Возвращаемое значение
СтрокаТаблицыЗначений
Вставить / Insert()
Вставляет строку в указанную позицию
Параметры
- index: Число - Индекс позиции куда будет произведена вставка
Возвращаемое значение
СтрокаТаблицыЗначений
Удалить / Delete()
Удаляет строку
Параметры
- row: СтрокаТаблицыЗначений - Удаляемая строка Число - Индекс удаляемой строки
ЗагрузитьКолонку / LoadColumn()
Загружает значения в колонку
Параметры
values: Массив - Значения для загрузки в колонку
columnIndex: Строка - Имя колонки для загрузки Число - Индекс колонки для загрузки КолонкаТаблицыЗначений - Колонка для загрузки
ВыгрузитьКолонку / UnloadColumn()
Выгружает значения колонки в новый массив
Параметры
- column: Строка - Имя колонки для выгрузки Число - Индекс колонки для выгрузки КолонкаТаблицыЗначений - Колонка для выгрузки
Возвращаемое значение
Массив
ЗаполнитьЗначения / FillValues()
Заполнить колонку/колонки указанным значением
Параметры
value: Произвольный - Устанавливаемое значение
columnNames: Строка - Список имен колонок для установки значения (разделены запятыми)
Индекс / IndexOf()
Получить индекс указанной строки
Параметры
- row: СтрокаТаблицыЗначений - Строка таблицы значений, для которой необходимо определить индекс
Возвращаемое значение
Число - Индекс в коллекции, если не найдено возвращает -1
Итог / Total()
Сумма значений всех строк указанной колонки
Параметры
- columnIndex: Строка - Имя колонки для суммирования Число - Индекс колонки для суммирования КолонкаТаблицыЗначений - Колонка для суммирования
Возвращаемое значение
Число
Найти / Find()
Осуществляет поиск значения в указанных колонках
Параметры
value: Произвольный - Искомое значение
columnNames: Строка - Список имен колонок для поиска значения (разделены запятыми). Если параметр не указан - ищет по всем колонкам. По умолчанию: пустая строка
Возвращаемое значение
СтрокаТаблицыЗначений - если строка найдена, иначе Неопределено
НайтиСтроки / FindRows()
Поиск строк по условию
Параметры
- filter: Структура - Условия поиска. Ключ - имя колонки, значение - искомое значение
Возвращаемое значение
Массив - Массив ссылок на строки, удовлетворяющих условию поиска
Очистить / Clear()
Удаляет все строки. Структура колонок не меняется.
Получить / Get()
Получить строку по индексу
Параметры
- index: Число - Индекс строки
Возвращаемое значение
СтрокаТаблицыЗначений
Свернуть / GroupBy()
Сворачиваются (группируются) строки по указанным колонкам измерениям, суммируются колонки ресурсов. Колонки не указанные ни в измерениях ни в ресурсах удаляются.
Параметры
groupColumnNames: Строка - Имена колонок для сворачивания (изменения), разделены запятыми
aggregateColumnNames: Строка - Имена колонок для суммирования (ресурсы), разделены запятыми
Сдвинуть / Move()
Сдвигает строку на указанное количество позиций.
Параметры
row: СтрокаТаблицыЗначений - Строка которую сдвигаем Число - Индекс сдвигаемой строки
offset: Количество строк, на которое сдвигается строка. Если значение положительное - сдвиг вниз, иначе вверх
СкопироватьКолонки / CopyColumns()
Создает новую таблицу значений с указанными колонками. Данные не копируются.
Параметры
- columnNames: Строка - Имена колонок для копирования, разделены запятыми
Возвращаемое значение
ТаблицаЗначений
Скопировать / Copy()
Создает новую таблицу значений с указанными строками и колонками. Если передан отбор - копирует строки удовлетворяющие отбору. Если не указаны строки - будут скопированы все строки. Если не указаны колонки - будут скопированы все колонки. Если не указаны оба параметра - будет создана полная копия таблицы значений.
Параметры
rows: Массив - Массив строк для отбора Структура - Параметры отбора. Ключ - Колонка, Значение - Значение отбора
columnNames: Строка - Имена колонок для копирования, разделены запятыми
Возвращаемое значение
ТаблицаЗначений
Сортировать / Sort()
Сортировать строки в таблице значений. Строки сортируются по порядку следования колонок для сортировки, с учетом варианта сортировки.
Параметры
columns: Строка - Имена колонок для сортировки. После имени колонки, через пробел, можно указать направление сортировки: "Убыв" ("Desc") - по убыванию. Возр" ("Asc") - по возрастанию По умолчанию - по возрастанию.
comparator: СравнениеЗначений - правила сравнения значений при наличии различных типов данных в колонке.
ВыбратьСтроку / ChooseRow()
Не поддерживается
Параметры
- title:
- startRow: