List.CopyTo

CopyTo (Копирование элементов)
Объект: Список Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Объект-приемник только для чтения Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Список

Функция копирует указанную часть списка в другой объект данных. Объект данных может иметь типы Список или Таблица. При копоровании в список, элементы добавляются в конец списка. При копировании в таблицу заполняется только один столбец с указанным именем, если имя не указано, либо столбца с таким именем нет в таблице, столбец будет добавлен (с пустым именем, либо указанным именем столбца). Количество строк в таблице будет увеличено до размера исходного списка, если это будет необходимо. Заполнение элементов в таблице начинается с первой строки и касается только одного столбца.
В список будут скопированы значения, их представления, индексы галочек и индексы иконок. В таблицу будут скопированы только значения и индексы иконок.

Синтаксис

List.CopyTo(<Объект-результат (LIST,TAB)>,<Индекс первого элемента (INT)>,<Количество элементов для копирования (INT)>,<Имя столбца таблицы для копирования (STRING)>)

Аргументы

• <Объект-результат (LIST,TAB)> - (возможен аргумент-переменная (ByRef)) Объект типа Список или Таблица, в который будет происходить копирование.
• <Индекс первого элемента (INT)> - (необязательный аргумент) Индекс (позиция) значения с которого начинается копирование.
• <Количество элементов для копирования (INT)> - (необязательный аргумент) Количество копируемых элементов. Если аргумент не указан будет скопированы значения от индекса первого элемента до конца списка.
• <Имя столбца таблицы для копирования (STRING)> - (необязательный аргумент) Имя столбца таблицы, в который будет происходить копирование.

Примеры

a:=List.Create();			//Список пуст
a.Add(1,2,3);				//Список содержит значения 1,2 и 3.
b:=List.Create(4);			//Список содержит значение 4.
a.CopyTo(b,2,2);			//Список b содержит значения 4,2,3