Tab.Move

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

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

Функция сдвигает строку с индексом, задаваемым первым аргументом, внутри таблицы на указанное количество строк. Расстояние сдвига может быть отрицательным числом. При положительном сдвиге, строка из конца таблицы переходит в ее начало, при отрицательном сдвиге строка с начала таблицы переходит в конец. Общее количество строк в таблице не меняется, индекс текущей строки может измениться в зависимости от положения сдвигаемой строки относительно текущей.

Синтаксис

Tab.Move(<Индекс перемещаемой строки (INT)>,<Расстояние перемещения (INT)>)

Аргументы

• <Индекс перемещаемой строки (INT)> - Числовой индекс строки, которую необходимо сдвинуть внутри таблицы.
• <Расстояние перемещения (INT)> - Количество строк, на которое необходимо осуществить сдвиг.

Примеры

//Создается и заполняется таблица значений
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.Select();
aTab.Move(2,-2);

aTab.Select();
While aTab.Next() Do
  Message("Строка "+aTab.CurLine+", b1:="+aTab.b1);
EndDo;
//Будет выведено последовательно (вторая строка была сдвинута на две позиции вверх, что вызвало ее появление снизу таблицы):
//"Строка 1, b1:=1"
//"Строка 2, b1:=3"
//"Строка 3, b1:=4"
//"Строка 4, b1:=4"
//"Строка 5, b1:=5"
//"Строка 6, b1:=2"