Как изменить текст в ячейке табличного документа 1С

Табличный документ в 1С — это универсальный объект, который используется для печатных форм, отчётов и макетов. Текст в его ячейках можно менять двумя принципиально разными способами: вручную в режиме просмотра или редактирования и программно — через встроенный язык. Выбор зависит от того, где находится документ: открыт ли он пользователем, формируется ли кодом или хранится как макет в конфигурации.

Частая причина вопроса — ячейка «не даёт» себя редактировать. Это нормальное поведение: у табличного документа есть свойство «Только просмотр», а у ячейки — защита и признак того, что она содержит параметр шаблона. Пока эти ограничения не сняты, никакой текст вписать не получится ни мышкой, ни кодом.

Ниже разобраны все рабочие сценарии: ручное редактирование, программная запись текста через область, работа с параметрами макета, замена текста в уже сформированных отчётах и типичные ошибки, из-за которых изменения «не применяются».

Как определить, почему ячейка не редактируется

Прежде чем менять текст, важно понять, в каком состоянии находится табличный документ. Если это печатная форма, открытая из документа, она почти всегда выводится с флагом «Только просмотр» — платформа намеренно блокирует правку, чтобы напечатанное не расходилось с данными учёта.

Вторая причина — защита ячейки или всего документа. В макете разработчик может установить у области свойство «Защита», и тогда даже при снятом «Только просмотр» содержимое останется недоступным для изменения. Третья ситуация — ячейка содержит не обычный текст, а параметр или шаблон: в макете она выглядит как [Параметр], и её «текст» на самом деле формируется при выводе.

Как изменить текст вручную в режиме редактирования

Если табличный документ открыт и доступен для правки, порядок простой. Включите режим редактирования: в тонком клиенте это команда «Ещё — Редактирование» или соответствующая кнопка на панели табличного документа (в разных конфигурациях интерфейс отличается). После этого двойной щелчок по ячейке переводит её в режим ввода, либо можно выделить ячейку и начать печатать — старое содержимое заменится.

Для точечной правки без замены всего содержимого выделите ячейку и нажмите F2 или щёлкните в строку формул — там отображается текущий текст ячейки, и его можно отредактировать частично. После ввода подтвердите изменение клавишей Enter.

1. 1
   Откройте табличный документ и включите режим редактирования (команда «Редактирование»)
2. 2
   Выделите нужную ячейку и нажмите F2 или дважды щёлкните по ней
3. 3
   Введите новый текст и нажмите Enter
4. 4
   Проверьте результат визуально и при необходимости сохраните документ в файл (Файл — Сохранить)

Учтите: изменения в открытой печатной форме не сохраняются обратно в данные документа. Если нужно, чтобы правка воспроизводилась при каждой печати, менять надо макет или код формирования, а не готовый табличный документ.

Как изменить текст программно через область

Программный способ — основной при автоматизации. Табличный документ в коде представлен объектом типа «ТабличныйДокумент», а доступ к ячейке даёт метод «Область». Обратиться можно по адресу в формате R1C1, по координатам строк и колонок или по имени области, если она названа в макете.

После получения области присвойте свойству «Текст» новое значение. Если область именованная и включает несколько ячеек, текст запишется в левую верхнюю ячейку области — это стандартное поведение платформы.

ТабДок = Новый ТабличныйДокумент;
Макет = ПолучитьМакет("МакетНакладной");
ТабДок.Вывести(Макет.ПолучитьОбласть("Шапка"));

// По адресу ячейки
ТабДок.Область("R2C3").Текст = "Новый текст";

// По имени области
ОбластьЗаголовок = ТабДок.Область("ЗаголовокДокумента");
ОбластьЗаголовок.Текст = "Счёт на оплату № " + НомерДокумента;

Перед записью полезно снять защиту: если документ или область защищены, присвоение текста вызовет ошибку. Для всего документа защита управляется свойством «Защита» табличного документа, для отдельных областей — одноимённым свойством области.

Как менять текст через параметры и шаблоны макета

Если ячейка макета содержит параметр (в конфигураторе виден как [ИмяПараметра]) или шаблон (например, «Покупатель: [Покупатель]»), записывать текст напрямую в ячейку после вывода — плохая практика. Правильно задать значение параметра до или при выводе области.

У объекта области макета есть коллекция «Параметры»: обращение идёт по имени параметра. После заполнения всех параметров область выводится в табличный документ методом «Вывести», и текст ячеек формируется автоматически с подстановкой значений.

ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьШапка.Параметры.Покупатель = "ООО Ромашка";
ОбластьШапка.Параметры.НомерДокумента = "0001-001234";
ТабДок.Вывести(ОбластьШапка);

Отличить параметр от обычного текста можно в конфигураторе: откройте макет, выделите ячейку и посмотрите свойство «Заполнение» — там будет значение «Параметр» или «Шаблон». Для шаблона текст ячейки содержит вставки вида [Имя], которые подменяются при выводе.

Как заменить текст в уже сформированном документе

Иногда табличный документ уже сформирован (например, отчёт СКД вывел результат, или файл mxl загружен с диска), и нужно найти и заменить конкретные значения. Прямого метода «найти и заменить» у табличного документа нет, поэтому применяют два подхода.

Первый — метод «НайтиТекст»: он возвращает область ячейки с искомым текстом, после чего ей можно присвоить новое значение. Второй — перебор ячеек по диапазону с проверкой содержимого и заменой по условию. Это удобно, когда заменить нужно не первое вхождение, а все совпадения.

// Разовая замена
Найденная = ТабДок.НайтиТекст("Старое значение");
Если Найденная <> Неопределено Тогда
    Найденная.Текст = "Новое значение";
КонецЕсли;

// Замена всех вхождений по диапазону
Для Строка = 1 По ТабДок.ВысотаТаблицы Цикл
    Для Колонка = 1 По ТабДок.ШиринаТаблицы Цикл
        Ячейка = ТабДок.Область(Строка, Колонка);
        Если Ячейка.Текст = "Старое значение" Тогда
            Ячейка.Текст = "Новое значение";
        КонецЕсли;
    КонецЦикла;
КонецЦикла;

Перебор по всем ячейкам — медленная операция на больших документах. Если документ содержит тысячи строк, ограничивайте диапазон поиска известными границами или используйте «НайтиТекст» в цикле с указанием области начала поиска.

Типичные ошибки и как их избежать

Самая частая жалоба — «присвоил текст, а он не изменился». Обычно причина в том, что код работает с одним экземпляром табличного документа, а на экране отображается другой: например, значение присвоено реквизиту формы после того, как форма уже отрисовалась, и требуется обновление, либо изменения вносятся в локальную переменную, которая никуда не выводится.

Вторая группа ошибок — работа с объединёнными ячейками. Если ячейки объединены, текст хранится в левой верхней ячейке объединения; запись в соседнюю ячейку диапазона визуально ничего не даст. Третья типичная ситуация — попытка записать текст в ячейку, содержащую картинку или имеющую тип «Рисунок»: сначала нужно изменить тип содержимого области.

Как проверить результат

После программной замены проверяйте не только визуальный вывод, но и само значение: прочитайте свойство «Текст» той же области и сравните с ожидаемым. Это отсекает ситуации, когда текст записался, но скрыт оформлением — например, белым цветом шрифта или нулевой высотой строки.

Для печатных форм финальная проверка — предварительный просмотр и пробная печать: переносы строк, автоподбор высоты и масштаб могут визуально «обрезать» длинный текст, хотя в ячейке он присутствует полностью.

Частые вопросы