Сдвигает строку таблицы значений с указанным смещением
Синтаксис
Метод Сдвинуть()
имеет следующий синтаксис:
Сдвинуть(Строка, Смещение)
А также альтернативный англоязычный синтаксис:
Move(ValueTableString, Offset)
Параметры
Описание параметров метода Сдвинуть()
:
Имя параметра* | Тип | Описание |
---|---|---|
Строка | Число | Индекс сдвигаемой строки таблицы значений |
СтрокаТаблицыЗначений | Сама сдвигаемая строка | |
Смещение | Число | Количество строк, на которое необходимо переместить строку |
*Жирным шрифтом выделены обязательные параметры |
Описание
Метод Сдвинуть()
сдвигает строку таблицы значений с указанным смещением вверх или вниз таблицы. Если указано положительное смещение, строка будет передвинута вниз (ближе к концу таблицы значений), если отрицательное — вверх (ближе к началу таблицы)
Внимание! В случае, если осуществляется попытка сместить строку за границы индексов таблицы, будет выдано сообщение об ошибке: «Неправильное смещение внутри коллекции». Программисту следует самостоятельно следить за тем, чтобы индекс сдвигаемой строки не выходил за границы таблицы
Доступность
Версия | Поддержка |
---|---|
8.1 | Сервер, Клиент, Внешнее соединение |
8.2 | Сервер, Толстый клиент, Внешнее соединение |
8.3 | Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение |
Пример использования
Пример кода с использованием метода Сдвинуть()
:
//получаем текущую строку ТекущаяСтрока = ЭлементыФормы.тз.ТекущаяСтрока; //сдвинуть вниз Сдвиг = 1; НовыйИндекс = тз.Индекс(ТекущаяСтрока) + Сдвиг; Если НовыйИндекс < тз.Количество() Тогда //строго меньше количества строк тз.Сдвинуть(ТекущаяСтрока, Сдвиг); КонецЕсли; //сдвинуть вверх Сдвиг = -1; НовыйИндекс = тз.Индекс(ТекущаяСтрока) + Сдвиг; Если НовыйИндекс >= 0 Тогда //больше или равен нулю (начальному индексу) тз.Сдвинуть(ТекущаяСтрока, Сдвиг); КонецЕсли;
Читайте также:
Программная работа с таблицей значений
Спасибо!