Получает область табличного документа как область ячеек табличного документа либо как рисунок с указанным именем. Область может состоять из нескольких расположенных подряд строк или колонок либо быть прямоугольной областью таблицы.
Синтаксис
Область(<ИмяОбласти>)Область(<НомерПервойСтроки>, <НомерПервойКолонки>, <НомерПоследнейСтроки>, <НомерПоследнейКолонки>, <ФорматСтрок>)Примеры платформы
ИменованнаяОбласть = ТабДок.Область("Шапка");
Ячейка = ТабДок.Область("R2C5");
ПрямоугольнаяОбластьЯчеек = ТабДок.Область("R2C2:R3C5");
ОбластьСтрока = ТабДок.Область("R2");
ОбластьСтрок = ТабДок.Область("R2:R4");
ОбластьКолонка = ТабДок.Область("C4");
ОбластьКолонок = ТабДок.Область("C4:C5");Полное описание, параметры и ограничения
ТабличныйДокумент.Область (SpreadsheetDocument.Area)
ТабличныйДокумент (SpreadsheetDocument)
Область (Area)
Доступен, начиная с версии 8.0.
Вариант синтаксиса: По имени
Синтаксис:
Область(<ИмяОбласти>)
Параметры:
<ИмяОбласти> (обязательный)
Тип: Строка.
Имя области или адрес в формате "R1C1:R2C2", где число после "R" обозначает номер строки, число после "C" - номер колонки, символом ":" (двоеточие) разделяются координаты левого верхнего и правого нижнего угла области. В качестве имени также можно передавать пересечение двух областей, записываемое как "<Имя области 1> | <Имя области 2>".
Вариант синтаксиса: По адресу
Синтаксис:
Область(<НомерПервойСтроки>, <НомерПервойКолонки>, <НомерПоследнейСтроки>, <НомерПоследнейКолонки>, <ФорматСтрок>)
Параметры:
<НомерПервойСтроки> (необязательный)
Тип: Число.
Номер первой строки области таблицы.
Если отсутствует, то указывается область, состоящая из колонок.
<НомерПервойКолонки> (необязательный)
Тип: Число.
Номер первой колонки области таблицы.
Если отсутствует, то указывается область, состоящая из строк.
<НомерПоследнейСтроки> (необязательный)
Тип: Число.
Номер последней строки области таблицы.
Если выделяется область из колонок (параметр <НомерПервойСтроки> не задан), то указывается номер строки, из которой берется формат строк.
<НомерПоследнейКолонки> (необязательный)
Тип: Число.
Номер последней колонки области таблицы.
<ФорматСтрок> (необязательный)
Тип: ФорматСтрокТабличногоДокумента.
Содержит формат строк, колонки которого нужно получать. Параметр можно указывать только при получении области колонок. Для других областей при указании этого параметра будет сгенерировано исключение.
Значение по умолчанию: Неопределено.
Описание варианта метода:
Если последняя строка и последняя колонка отсутствуют, то область задана единственной ячейкой. Если строки или колонки отсутствуют, то область задана диапазоном строк или колонок соответственно. Если метод вызван без параметров, то область задана всей таблицей.
Нумерация строк и колонок начинается с 1. Значение 0 трактуется как 1.
Возвращаемое значение:
Тип: ОбластьЯчеекТабличногоДокумента, РисунокТабличногоДокумента.
Описание:
Получает область табличного документа как область ячеек табличного документа либо как рисунок с указанным именем. Область может состоять из нескольких расположенных подряд строк или колонок либо быть прямоугольной областью таблицы.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
ИменованнаяОбласть = ТабДок.Область("Шапка");
Ячейка = ТабДок.Область("R2C5");
ПрямоугольнаяОбластьЯчеек = ТабДок.Область("R2C2:R3C5");
ОбластьСтрока = ТабДок.Область("R2");
ОбластьСтрок = ТабДок.Область("R2:R4");
ОбластьКолонка = ТабДок.Область("C4");
ОбластьКолонок = ТабДок.Область("C4:C5");
См. также:
ОбластьЯчеекТабличногоДокумента
Использование в версии:
Доступен, начиная с версии 8.0.
Описание изменено в версии 8.3.22.
Методическая информация
Практические примеры
Получить собственный макет этикетки через объект товара
Макет хранится в метаданных справочника, а товар содержит данные. Получаем настроенный табличный макет и меняем его учебную ячейку в памяти без файла и печати.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.
До запуска дополнительно создайте у УчебныеТовары макет УчебнаяЭтикетка типа Табличный документ. В его ячейках A1/A2 задайте учебные подписи и обновите конфигурацию.
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Товар = Справочники.УчебныеТовары.СоздатьЭлемент();
Товар.Наименование = "Учебная книга";
Товар.Артикул = "A-01";
Товар.Цена = 250;
Этикетка = Товар.ПолучитьМакет("УчебнаяЭтикетка");
Сообщить(ТипЗнч(Этикетка) = Тип("ТабличныйДокумент"));
Этикетка.Область(1, 1).Текст = Товар.Наименование;
Этикетка.Область(2, 1).Текст = "Артикул: " + Товар.Артикул;
Сообщить(Этикетка.Область(1, 1).Текст = "Учебная книга");
Сообщить(Этикетка.Область(2, 1).Текст = "Артикул: A-01");
Сообщить(Товар.ЭтоНовый());Разбор по шагам
ПолучитьМакет получает объект ресурса по точному имени. Отсутствующий макет должен исправляться в подготовке, а не заменяться произвольным файлом.
Область(1,1) адресует ячейку по строке/колонке. Наименование и артикул берём из собственного незаписанного товара.
Изменяем полученный табличный документ в памяти. Показ, печать и запись PDF/файла не вызываются.
Как проверить результат
Четыре сообщения Истина; A1 содержит Учебная книга, A2 — Артикул: A-01.
Проверьте макет в Конфигураторе: присваивание ячеек во время выполнения не редактировало источник метаданных.
Ожидаемый результат
Собственный макет справочника заполнен данными товара в памяти.
На что обратить внимание
Имя макета и имя товара — разные имена; макет не является реквизитом объекта.
Для макета другого типа методы Область/Текст неприменимы. Подготовка явно задаёт Табличный документ.
Этот код не создаёт промышленную печатную форму и не проверяет физическую печать.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Заполнить собственную диаграмму табличного документа и восстановить обновление при ошибке
Разбираем Обновление в его контексте обычного толстого клиента. В управляемых формах отключение этого свойства не является ускорением.
Где и как запускать
Учебное обычное приложение, толстый клиент Windows: собственная обычная форма внешней обработки. Это не модуль управляемой формы и не серверный вызов.
Подготовка
Отдельная пустая учебная конфигурация для ОБЫЧНОГО приложения, толстый клиент Windows. Не переключайте рабочую конфигурацию и не запускайте урок в тонком клиенте.
В собственной внешней обработке создайте обычную форму, добавьте кнопку УчебныйПример и назначьте её Действие одноимённой процедуре. Код — полный обработчик модуля формы, без &НаКлиенте.
Документ и его рисунок создаются кодом заново. Макет типового отчёта, рабочий табличный документ и исходные файлы не используются.
Процедура УчебныйПример(Кнопка)
Документ = Новый ТабличныйДокумент;
Рисунок = Документ.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Диаграмма);
Рисунок.Расположить(Документ.Область(1, 1, 20, 12));
Диаграмма = Рисунок.Объект;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
ПрежнееОбновление = Диаграмма.Обновление;
Диаграмма.Обновление = Ложь;
Попытка
Продажи = Диаграмма.УстановитьСерию("sales");
Продажи.Текст = "Продано, шт.";
Для Месяц = 1 По 3 Цикл
Точка = Диаграмма.УстановитьТочку(Месяц);
Точка.Текст = "Месяц " + Строка(Месяц);
Диаграмма.УстановитьЗначение(Точка, Продажи, Месяц * 5);
КонецЦикла;
Диаграмма.ОбластьЗаголовка.Текст = "Собственные значения 5/10/15";
Диаграмма.Обновление = ПрежнееОбновление;
Исключение
Диаграмма.Обновление = ПрежнееОбновление;
ВызватьИсключение;
КонецПопытки;
Сообщить(Диаграмма.Обновление = ПрежнееОбновление);
Сообщить(Диаграмма.Точки.Количество() = 3);
Документ.Показать("Учебная диаграмма — без файла и печати");
КонецПроцедурыРазбор по шагам
Коллекция рисунков нового табличного документа создаёт рисунок типа Диаграмма. Рисунок.Объект содержит именно диаграмму.
Расположить принимает область ячеек, а не четыре отдельных числа. Используем собственную область 1,1–20,12.
Сохраняем прежний режим Обновление, отключаем его на время пакетного заполнения и возвращаем при успехе и при исключении.
Создаются три собственные точки 5/10/15. Показать открывает новый документ, но не вызывает печать или сохранение.
Смысл свойства сверяется со справкой платформы; похожая работа с Обновление найдена в исходном отчёте УТ 10.3, но этот пример не вызывает его код.
Как проверить результат
Два сообщения Истина: режим обновления восстановлен, точек три.
Открытый собственный табличный документ показывает 5/10/15. Файл не создаётся и печать не запускается.
Для отрицательного теста добавьте ВызватьИсключение внутри Попытка: перед повторным выбросом прежний режим всё равно восстанавливается.
Ожидаемый результат
Пакетное заполнение и восстановление состояния разобраны в подходящем клиентском контексте, без обещания ускорения управляемой формы.
На что обратить внимание
В управляемых формах установка Обновление не влияет на производительность. Используйте для них обычные уроки Диаграмма без этого приёма.
Показать — интерактивная клиентская операция; серверный фрагмент не может открыть пользователю это окно.
Сохранённый прежний режим может быть Ложь. Возвращаем именно его, а не безусловно включаем чужое состояние.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.