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