ВставитьПоле

Добавляет поле в таблице в окне или диалоге. Аналог команды "Вставить столбец" (<Shift+Insert>). Функция обратная функции "УдалитьПоле".

Синтаксис

Окно.ВставитьПоле(ИмяПоля)
Окно.ВставитьПоле(ИмяТаблицы, ИмяПоля[, НазваниеПоля[, ВставлятьПосле]])

Параметры

ИмяТаблицы (текст) – имя таблицы с записями, в которую нужно добавить поле. Параметр имеет смысл применять, если окно или диалог содержит более одной таблицы с записями. Если параметр не указан, то поле вставляется в первую попавшуюся таблицу в окне.

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

НазваниеПоля (текст) – пользовательское название поля, которое добавляется в таблицу. Если параметр не указан, то в этом случае название поля будет совпадать с именем этого поля в базе данных.

ВставлятьПосле (текст) – имя поля, после которого вставляется указанное поле. Если у параметра указать "-", то поле добавляется перед указанным полем. Если параметр не указан, то поле добавляется после всех отображаемых полей в таблице.

Комментарий

Диалог должен содержать таблицу с записями.

Возвращает

Да (логическое значение) – если поле добавлено в таблицу.

Нет (логическое значение) – если поле не добавлено в таблицу.

Примеры

Добавим поле "ОКПО" в справочнике организаций:

оОкно=Окно("Организации");
оОкно.ВставитьПоле("ОКПО");
оОкно.Открыть();

Поместим поле "ОКПО" перед полем "Телефон":

оОкно=Окно("Организации");
Сообщить(оОкно.ВставитьПоле("Организации", "ОКПО", "ОКПО Организации", "-Телефон"));
оОкно.Открыть();

См. также:

•  СпрятатьПоле

•  УдалитьПоле