Перейти к основному содержимому

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

Стд::ТабличныйДокумент::ТабличныйДокумент Доступность: Сервер

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

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

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

Базовые типы: Объект

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

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

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

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

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

Свойства​

Запись​

Доступность: Сервер ТолькоЧтение

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

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

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

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

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

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

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

ПолеСверху​

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

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

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

ПолеСлева​

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

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

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

ПолеСнизу​

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

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

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

ПолеСправа​

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

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

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

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

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

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

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

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

Рисунки​

Доступность: Сервер ТолькоЧтение

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

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

Методы​

ВБайты​

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

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

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

Записать​

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Доступность: Сервер Статический

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

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

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

Поддерживается чтение табличного документ только из формата MXL.

Примеры​

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

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

Доступность: Сервер Статический

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

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

  • Источник - Путь к файлу.

Поддерживаются следующие форматы файлов:

  • Табличный документ MXL
  • Microsoft Excel XLS/XLSX
  • OpenOffice Calc ODS

Формат файла определяется из расширения файла. Если формат файла не удалось определить - табличный документ читается как MXL.

Примеры​

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

ПолучитьИменованныеОбласти​

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

ПолучитьИменованныеОбласти(): ЧитаемыйМассив<ОбластьТабличногоДокумента>

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

Примеры​

метод ВМакетеЕстьОбластьПодписи(Макет: ТабличныйДокумент)
	знч Области = Макет.ПолучитьИменованныеОбласти()
	для Область из Области
		если Область.Имя == "ОбластьПодписи"
			возврат Истина
		;
	;

	возврат Ложь
;

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

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

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

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

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

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

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

Возвращает указанную область табличного документа или Неопределено, если указанная область является рисунком. Область можно адресовать по имени или адресу в формате "R1C1:R2C2", где число после "R" обозначает номер строки, число после "C" - номер колонки, символом ":" (двоеточие) разделены координаты левого верхнего и правого нижнего угла области. В качестве имени также можно передавать пересечение двух областей, записываемое как "<Имя области 1> | <Имя области 2>".

Исключения​

ИсключениеНедопустимыйАргумент - Если получаемая сущность является рисунком табличного документа.

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

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

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

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

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

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

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

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

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

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

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

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

Прочитать​

Доступность: Сервер Статический

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

Возвращает табличный документ, прочитанный из данные в памяти.

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

Поддерживается чтение табличного документ только из формата MXL.

Исключения​

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

Прочитать​

Доступность: Сервер Статический

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

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

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

Поддерживаются следующие форматы файлов:

  • Табличный документ MXL
  • Microsoft Excel XLS/XLSX
  • OpenOffice Calc ODS

Формат файла определяется из расширения файла. Если формат файла не удалось определить - табличный документ читается как MXL.

Исключения​

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

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

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

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

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

  • Формат - Формат экспорта табличного документа.
  • ПутьФайла - Путь к результирующему файлу.

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

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

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

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

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

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

  • Формат - Формат экспорта табличного документа.
  • Поток - Поток записи, в который будет записан табличный документ в указанном формате.

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

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

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

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

  • Формат - Формат экспорта табличного документа.

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

Объект​

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

Последнее обновление