Difference between revisions of "Tab.InsertLine"

From SunFlurry wiki
Jump to: navigation, search
(Created page with "{{infobox function |name=InsertLine |object=Таблица |caption=Работа со строками |type=1 |status=2 |db=0 |exception=Невозможно превра...")
 
m (1 revision imported)
 
(No difference)

Latest revision as of 08:53, 7 February 2021

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

Функция вставляет строку в таблицу по указанному индексу и помечает ее как текущую (т.е. атрибут CurLine изменяется на индекс вставляемой строки). Указанные в первом аргументе столбцы таблицы, в добавленной строке будут заполнены значениями, заданными последующими аргументами.

Синтаксис

Tab.InsertLine(<Индекс добавляемой строки (INT)>,<Наименования столбцов через запятую (STRING)>,<Значение столбца 1>,<Значение столбца 2>...)

Аргументы

  • <Индекс добавляемой строки (INT)> - Число, задающее индекс строки для вставки, индекс первой строки равен 1, если индекс указывает на строку за последней строкой таблицы, действие функции будет аналогичным функции AddLine.
  • <Наименования столбцов через запятую (STRING)> - Наименования столбцов, разделенные запятой для заполнения. Количество наименований должно совпадать с количеством аргументов, следующих за данным.
  • <Значение столбца ?> - (необязательный аргумент) Значения произвольного типа, которыми будут заполнены ячейки новой строки таблицы в столбцах, перечисленных в первом аргументе.

Примеры

//Создается и заполняется таблица значений
aTab:=Tab.Create("b1,b2,b3,b4");

aTab.AddLine("b1,b2,b3,b4",1,2,3,4);
aTab.AddLine("b1,b2,b3,b4",2,2,3,4);
aTab.AddLine("b1,b2,b3,b4",3,5,5,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);
aTab.InsertLine(2,"b1,b2,b3,b4",2,1,3,40);

Message(aTab.Size());
//Выводит число 7

Message(aTab.Get(2,"b4"));
//Выводит число 40