Руководство разработчика

Метод ТАБ_ФОРМА.ДОБАВИТЬ_СТРОКУ

Метод ДОБАВИТЬ_СТРОКУ позволяет создать новую строку и разместить ее в позиции после заданной.

ФУНКЦИЯ ЛОГИКА: ДОБАВИТЬ_СТРОКУ(СТРОКА: раздел; 
                                ЦЕЛОЕ: поз)

Параметры

раздел
Имя раздела для добавления строки.
поз
Позиция, после которой осуществляется добавление.

Возвращаемое значение

ДА – в случае успешного выполнения, НЕТ – в случае ошибки.

При добавлении новой строки, ее структура, атрибуты и данные ячеек могут быть взяты из строки, расположенной в позиции поз (исходной). Что именно будет взято из исходной строки, определяется текущим режимом добавления, который может быть установлен методом УСТ_РЕЖ_ДОБАВЛЕНИЯ.

Также режим добавления определяет способ трансформации границ ячеек согласно правилам деления границ. Новая строка, в общем случае, имеет две соседние строки – сверху и снизу. До добавления эти строки имели общие горизонтальные границы ячеек. Добавление новой строки делит эти границы на две: между ячейками верхней строки и новой, между ячейками новой строки и нижней. Режим деления задается константами деления границ ТФ_ДГ_... Вертикальные границы ячеек в новой строке могут заимствоваться как из верхней строки, так из нижней. Режим копирования вертикальных границ определяется константами константами ТФ_КГ_... Подробнее о режиме добавления см. описание типа ТФ_РЕЖИМ_ДОБАВЛЕНИЯ.

Вставить строку перед заданной позицией можно методом ВСТАВИТЬ_СТРОКУ.

В нерегулярном разделе новая строка всегда имеет тот же набор столбцов, что и исходная.

Пример добавления строк в табличную форму.


См. также: