Очищает табличный документ.
Синтаксис
Очистить()Примеры платформы
ТабДок.Очистить();Полное описание, параметры и ограничения
ТабличныйДокумент.Очистить (SpreadsheetDocument.Clear)
ТабличныйДокумент (SpreadsheetDocument)
Очистить (Clear)
Доступен, начиная с версии 8.0.
Синтаксис:
Очистить()
Описание:
Очищает табличный документ.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Пример:
ТабДок.Очистить();
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Отличить область исходной таблицы от её независимой копии
Область позволяет менять оригинал; ПолучитьОбласть создаёт отдельный табличный документ. Проверяем оба варианта на собственных ячейках.
Где и как запускать
В учебной управляемой форме создайте команду УчебныйПример и кнопку для неё. Назначьте обработчик действия УчебныйПример. Приведённую процедуру целиком вставьте в модуль формы. Не вставляйте её внутрь другой процедуры. Запустите форму в тонком или толстом клиенте Windows.
Подготовка
Создайте отдельную учебную обработку с управляемой формой; рабочие печатные формы не изменяйте.
ТабличныйДокумент.Показать открывает окно просмотра, но не отправляет документ на физический принтер.
&НаКлиенте
Процедура УчебныйПример(Команда)
Исходный = Новый ТабличныйДокумент;
Исходный.Область(1, 1).Текст = "Книга";
Исходный.Область(2, 1).Текст = "Ручка";
СсылкаНаОбласть = Исходный.Область("R1C1:R1C1");
Копия = Исходный.ПолучитьОбласть(1, 1, 2, 1);
СсылкаНаОбласть.Текст = "Книга исправленная";
Сообщить(Исходный.Область(1, 1).Текст);
Сообщить(Копия.Область(1, 1).Текст);
Копия.Область(2, 1).Очистить(Истина, Ложь, Ложь);
Сообщить(Исходный.Область(2, 1).Текст);
Результат = Новый ТабличныйДокумент;
Результат.Вывести(Исходный);
Результат.Вывести(Копия);
Результат.Область(, 1, , 1).ШиринаКолонки = 32;
Результат.Показать("Оригинал и независимая копия");
Копия.Очистить();
Сообщить(Исходный.Область(1, 1).Текст);
КонецПроцедурыРазбор по шагам
Заполняем две строки и получаем ссылку на первую ячейку оригинала методом Область.
ПолучитьОбласть возвращает новый ТабличныйДокумент с двумя скопированными строками.
Изменение ссылки затрагивает оригинал, а очистка ячейки копии — только копию.
Вывести добавляет оба документа последовательно в результат. Очистка копии не меняет исходный документ.
Как проверить результат
После изменения вывод: Книга исправленная у оригинала и Книга у копии.
После очистки второй ячейки копии оригинал по-прежнему содержит Ручка.
После полной очистки копии оригинал содержит Книга исправленная; вывод в Результат уже выполнен.
Ожидаемый результат
На конкретных ячейках показано различие между ссылкой на область и отдельной копией.
На что обратить внимание
Не используйте Область вместо ПолучитьОбласть, если собираетесь исправлять копию независимо от исходника.
Очистить у области управляет текстом, форматированием и рамками отдельными параметрами; у ТабличногоДокумента очищается весь документ.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.