Admin: 1 revision imported

2021-02-07T06:54:50Z

1 revision imported

Admin: Created page with "{{infobox function |name=CopyTo |object=Дерево |caption=Копирование данных |type=1 |status=2 |db=0 |exception=Невозможно преврати..."

2020-03-18T08:57:25Z

Created page with "{{infobox function |name=CopyTo |object=Дерево |caption=Копирование данных |type=1 |status=2 |db=0 |exception=Невозможно преврати..."

New page

{{infobox function
|name=CopyTo
|object=[[Дерево]]
|caption=Копирование данных
|type=1
|status=2
|db=0
|exception=Невозможно превратить в число, неверный индекс.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Дерево]]}}
Применимо к объектам ветки и дерева. Функция осуществляет копирование значений дочерних веток текущего объекта в указанный объект (другого дерева, списка или таблицы значений).

== Синтаксис ==
<code>
{{Grey|Tree.}}'''CopyTo'''({{ByRef|<Объект в который происходит копирование>}}{{Optional|,<Индекс начальной ветки копирования (INT),<Количество веток для копирования (INT)>}})
</code>

==== Аргументы ====
* <code>''<Объект в который происходит копирование>''</code> - {{ByRef}} Аргумент задает объект, в который будет происходить копирование. Аргумент должен представлять собой переменную, переменная может иметь следующий тип данных:
** '''Список значений''': Каждая ветка текущего уровня добавляется в список последовательно (добавляется наименование, статус галки, иконка, значение). Если текущая ветка содержит подчиненные ветки, вместо значения в список добавляется новый список, для которого выполняется рекурсивная процедура копирования с ветками, подчиненными данной.
** '''Таблица значений''': В таблицу значений добавляется новый столбец без имени, для каждой копируемой ветки, в таблицу добавляется строка, в новый столбец копируются значение, иконка и статус галки текущей ветки. Подчиненные ветки текущей ветки игнорируются.
** '''Дерево''': Происходит копирование структуры из текущего объекта в указанное дерево, текущая структура дерева сохраняется, новые ветки будут добавлены без удаления существующих.
** '''Ветка дерева''': Происходит копирование структуры из текущего объекта в указанную ветку дерева, текущая структура ветки сохраняется, новые ветки будут добавлены без удаления существующих.
** '''Переменная другого типа''': Значение переменной будет очищено и будет создано новое пустое дерево, затем будет выполнена процедура копирования, описанная выше.
* <code>''<Индекс начальной ветки копирования (INT)>''</code> - {{Optional}} Индекс подчиненной ветки, с которой начинается копирование. По умолчанию, копирование начинается с первой подчиненной ветки.
* <code>''<Количество веток для копирования (INT)>''</code> - {{Optional}} Количество копируемых веток. По умолчанию, копируются ветки с начальной до конечной.

== Примеры ==
<pre>
aTree:=Tree.Create();
aBranch1:=aTree.Add(1,"Ветка 1");
aBranch1.Add(2,"Ветка 1.1");
aTree.Add(3,"Ветка 2");
bTree:=Tree.Create();
aTree.CopyTo(bTree,1,1);

//Будет выведено 2
Message("Значение ветки 1.1: "+bTree.ByIndex(1).ByIndex(1).Value);
</pre>

← Older revision	Revision as of 06:54, 7 February 2021
(No difference)

Tree.CopyTo - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=CopyTo |object=Дерево |caption=Копирование данных |type=1 |status=2 |db=0 |exception=Невозможно преврати..."