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

Метод ТАБ_ФОРМА.ВСТАВИТЬ_СТОЛБЕЦ

Метод ВСТАВИТЬ_СТОЛБЕЦ позволяет создать новый столбец и разместить его в позиции перед заданным. В регулярном разделе столбец добавляется для раздела в целом, соответствующие ячейки создаются в каждой строке. В нерегулярном разделе столбец добавляется только в одну строку, позиция которой задается. При этом создается только одна новая ячейка.

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

Параметры

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

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

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

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

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

Добавить столбец после заданной позиции можно методом ДОБАВИТЬ_СТОЛБЕЦ.

Пример

ВСТАВИТЬ_РАЗДЕЛ(КОЛ_РАЗДЕЛОВ + 1, ДА, "Раздел"+ СТР(КОЛ_РАЗДЕЛОВ + 1))
ПЕРЕМ  имя_разд = ИМЯ_РАЗДЕЛА(КОЛ_РАЗДЕЛОВ)
ВСТАВИТЬ_СТОЛБЕЦ(имя_разд, 1, 0)

См. также: