ТабличныйДокумент

Стд::ТабличныйДокумент::ТабличныйДокумент
Базовые типы: Объект

Доступность: Сервер

Иерархия типа

graph TD;
ТабличныйДокумент["ТабличныйДокумент"]-->Объект["Объект"];

Позволяет формировать печатные формы и конвертировать их в различные форматы. Обеспечивается совместимость с 1С:Предприятие 8 (с некоторыми ограничениями)

Сравнение ссылочное.

Конструкторы

ТабличныйДокумент

ТабличныйДокумент()

Доступность: Сервер

Создает пустой табличный документ

Свойства

Запись

ТолькоЧтение Запись: ЗаписьТабличногоДокумента

Доступность: Сервер

Писатель табличного документа.

ОриентацияСтраницы

ОриентацияСтраницы: ОриентацияСтраницы

Доступность: Сервер

Ориентация страницы при выводе таблицы на печать или экспорте в другие форматы (например, PDF)

Способа сделать в одном табличном документе страницы с разной ориентацией нет.

ПолеСверху

ПолеСверху: Число

Доступность: Сервер

Поле отступа сверху при печати (в миллиметрах).

ПолеСлева

ПолеСлева: Число

Доступность: Сервер

Поле слева снизу при печати (в миллиметрах).

ПолеСнизу

ПолеСнизу: Число

Доступность: Сервер

Поле отступа снизу при печати (в миллиметрах).

ПолеСправа

ПолеСправа: Число

Доступность: Сервер

Поле справа снизу при печати (в миллиметрах).

РазмерСтраницы

РазмерСтраницы: РазмерСтраницы

Доступность: Сервер

Физические (для печати) размеры страницы.

Размеры указаны для портретной ориентации и не меняются при смены ориентации страницы!

Рисунки

ТолькоЧтение Рисунки: РисункиТабличногоДокумента

Доступность: Сервер

Методы

ВБайты

ВБайты(): Байты

Доступность: Сервер

Получает двоичное представление табличного документа, которое можно записать в файл или передать по сети. Восстановить из двоичного представления можно при помощи метода [Spreadsheet.Read]

Записать

Записать(ПутьФайла: Строка)

Доступность: Сервер

Записывает табличный документ в файл по указанному пути. Для табличного документа традиционно используется расширение “mxl”.

КоличествоКолонок

КоличествоКолонок(): Число

Доступность: Сервер

Количество колонок в таблице.

КоличествоСтраниц

КоличествоСтраниц(): Число

Доступность: Сервер

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

КоличествоСтрок

КоличествоСтрок(): Число

Доступность: Сервер

Количество строк в таблице

ПолучитьДиапазоныОбластейСНеподдерживаемымОформлением

Статический ПолучитьДиапазоныОбластейСНеподдерживаемымОформлением(Источник: Байты|Файл|ПотокЧтения|Строка): ЧитаемыйМассив<Строка>

Доступность: Сервер

Возвращает список областей с неподдерживаемым оформлением областей табличного документа.

Источник - Источник табличного документа.

Примеры

пер ТабличныйДокумент: ТабличныйДокумент?
попытка
	ТабличныйДокумент = ТабличныйДокумент.Прочитать(ПутьКДокументу)
поймать (Исключение: ИсключениеНедопустимоеОформлениеТабличногоДокумента)
    // (R1C1,R2C5)
  	пер ДиапазоныДляОбработки = ТабличныйДокумент.ПолучитьДиапазоныОбластейСНеподдерживаемымОформлением(ПутьКДокументу)
;

ПолучитьКолонки

ПолучитьКолонки(
  НомерПервойКолонки: Число,
  НомерПоследнейКолонки: Число
): ОбластьТабличногоДокумента

Доступность: Сервер

Возвращает область, состоящую из указанных колонок документа.

ПолучитьОбласть

ПолучитьОбласть(ИмяОбласти: Строка): ОбластьТабличногоДокумента

Доступность: Сервер

Перегрузка:
ПолучитьОбласть(НомерПервойСтроки: Число, НомерПервойКолонки: Число, НомерПоследнейСтроки: Число, НомерПоследнейКолонки: Число): ОбластьТабличногоДокумента

ПолучитьОбласть

ПолучитьОбласть(
  НомерПервойСтроки: Число,
  НомерПервойКолонки: Число,
  НомерПоследнейСтроки: Число,
  НомерПоследнейКолонки: Число
): ОбластьТабличногоДокумента

Доступность: Сервер

Перегрузка:
ПолучитьОбласть(ИмяОбласти: Строка): ОбластьТабличногоДокумента

Возвращает указанную область табличного документа.

ПолучитьСтроки

ПолучитьСтроки(
  НомерПервойСтроки: Число,
  НомерПоследнейСтроки: Число
): ОбластьТабличногоДокумента

Доступность: Сервер

Возвращает область, состоящую из указанных строка документа.

ПолучитьЯчейку

ПолучитьЯчейку(
  НомерСтроки: Число,
  НомерКолонки: Число
): ОбластьТабличногоДокумента

Доступность: Сервер

Возвращает указанную ячейку документа.

Прочитать

Статический Прочитать(
  Источник: Байты|Файл|ПотокЧтения|Строка,
  КонвертироватьОформление: Булево = Ложь
): ТабличныйДокумент

Доступность: Сервер

Читает табличный документ из данных в памяти или из файла.

Источник - Источник табличного документа.
КонвертироватьОформление - конвертировать при чтении неподдерживаемое оформление.

Исключения

ИсключениеНедопустимоеОформлениеТабличногоДокумента - Если цвета или шрифты не поддерживаются в “1С Предприятие: Элемент”. В тексте ошибки будет указан только первый диапазон области, в которой обнаружена ошибка чтения. Для чтения табличного документа с конвертацией оформления, нужно воспользоваться параметром КонвертироватьОформление со значением Истина.

Экспортировать

Экспортировать(
  Формат: ФорматЭкспортаТабличногоДокумента,
  ПутьФайла: Строка)

Доступность: Сервер

Перегрузка:
Экспортировать(Формат: ФорматЭкспортаТабличногоДокумента, Поток: ПотокЗаписи)

Экспортирует табличный документ в файл указанного формата.

// Экспортируем один и тот же документ во все поддерживаемые форматы

для Формат из Тип<ФорматЭкспортаТабличногоДокумента>.Элементы()
    ТабличныйДокумент.Экспортировать(Формат, БазовоеИмяФайла+Формат.ВСтроку())
;

Экспортировать

Экспортировать(
  Формат: ФорматЭкспортаТабличногоДокумента,
  Поток: ПотокЗаписи)

Доступность: Сервер

Перегрузка:
Экспортировать(Формат: ФорматЭкспортаТабличногоДокумента, ПутьФайла: Строка)

Экспортирует табличный документ в поток в указанном формате.

ЭкспортироватьВБайты

ЭкспортироватьВБайты(Формат: ФорматЭкспортаТабличногоДокумента): Байты

Доступность: Сервер

Экспортирует табличный документ в массив байтов в указанном формате.

Список унаследованных методов

Объект

ВСтроку, ПолучитьТип, Представление