Тип: Число. Содержит ширину поля отступа слева при печати (в миллиметрах). Значение по умолчанию 10.
Полное описание, параметры и ограничения
ТабличныйДокумент.ПолеСлева (SpreadsheetDocument.LeftMargin)
ТабличныйДокумент (SpreadsheetDocument)
ПолеСлева (LeftMargin)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Число.
Содержит ширину поля отступа слева при печати (в миллиметрах). Значение по умолчанию 10.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Сохранить таблицу в PDF и проверить MXL без файлов
Подготавливаем страницу, записываем PDF в память, затем сохраняем MXL и проверяем числовую ячейку после обратного чтения.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Выполняйте на сервере учебной базы Windows. Публикация, физический принтер и внешние файлы не нужны.
Потоковая запись и чтение доступны не для всех форматов. Этот пример читает обратно именно MXL, а не PDF или XLSX.
ТабДок = Новый ТабличныйДокумент;
ТабДок.Область(1, 1).Текст = "Учебный остаток";
ТабДок.Область(2, 1).Текст = "Книга";
Ячейка = ТабДок.Область(2, 2);
Ячейка.СодержитЗначение = Истина;
Ячейка.Значение = 3;
Ячейка.Формат = "ЧДЦ=0; ЧГ=0";
ТабДок.Область(, 1, , 1).ШиринаКолонки = 30;
ТабДок.РазмерСтраницы = "A4";
ТабДок.ОриентацияСтраницы = ОриентацияСтраницы.Портрет;
ТабДок.ПолеСлева = 10;
ТабДок.ПолеСправа = 10;
ТабДок.ПолеСверху = 15;
ТабДок.ПолеСнизу = 15;
ТабДок.АвтоМасштаб = Истина;
Поток = Неопределено;
Чтение = Неопределено;
Попытка
Поток = Новый ПотокВПамяти;
ТабДок.Записать(Поток, ТипФайлаТабличногоДокумента.PDF);
PDF = Поток.ЗакрытьИПолучитьДвоичныеДанные();
Поток = Неопределено;
Если Лев(ПолучитьHexСтрокуИзДвоичныхДанных(PDF), 8) <> "25504446" Тогда
ВызватьИсключение "Нет сигнатуры %PDF в начале документа";
КонецЕсли;
Сообщить(СтрШаблон("PDF: %1 байт", PDF.Размер()));
Поток = Новый ПотокВПамяти;
ТабДок.Записать(Поток, ТипФайлаТабличногоДокумента.MXL);
MXL = Поток.ЗакрытьИПолучитьДвоичныеДанные();
Поток = Неопределено;
Чтение = MXL.ОткрытьПотокДляЧтения();
Копия = Новый ТабличныйДокумент;
Копия.Прочитать(Чтение, , ТипФайлаТабличногоДокумента.MXL);
Чтение.Закрыть();
Чтение = Неопределено;
Сообщить(Копия.Область(2, 1).Текст);
Сообщить(Копия.Область(2, 2).Значение);
Если Копия.Область(2, 2).Значение <> 3 Тогда
ВызватьИсключение "Числовая ячейка не восстановилась";
КонецЕсли;
Исключение
Если Чтение <> Неопределено Тогда
Чтение.Закрыть();
КонецЕсли;
Если Поток <> Неопределено Тогда
Поток.Закрыть();
КонецЕсли;
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Создаём таблицу с текстом и числом, задаём A4, ориентацию и поля в миллиметрах.
PDF записывается в отдельный поток памяти. Полученные данные должны начинаться байтами %PDF.
В новом потоке сохраняем MXL — собственный формат табличного документа.
Читаем MXL в другой ТабличныйДокумент, проверяем текст и исходное числовое значение. Все потоки закрываем.
Как проверить результат
PDF имеет ненулевой размер и сигнатуру Hex 25504446. Это проверка формата, не визуального расположения страницы.
После чтения MXL: текст Книга, числовое значение 3; свойства исходного документа не подменяются строковым представлением.
Измените число на 7 и контрольное значение тоже на 7: после обратного чтения должно сохраниться 7.
Ожидаемый результат
Созданы двоичные PDF и MXL в памяти; MXL успешно прошёл предусмотренную самопроверку при выполнении урока.
На что обратить внимание
Запуск данного BSL в 1С ещё не проверялся. При ошибке PDF проверьте доступность формата, шрифтов и особенности серверного окружения.
Сигнатура PDF не доказывает, что документ красиво выглядит: итоговую печатную форму проверяйте визуально.
Для передачи PDF клиенту нужны отдельные механизмы передачи файлов; двоичные данные на сервере не открываются у пользователя сами.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Подготовить бумагу 148×210 мм и повторение первой колонки
Настраиваем собственный размер страницы и повторяющийся столбец товара. Упражнение не вызывает принтер и не обещает одинаковое число страниц у разных драйверов.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = УчебнаяТаблица();
ТабДок.РазмерСтраницы = "Custom";
ТабДок.ШиринаСтраницы = 148;
ТабДок.ВысотаСтраницы = 210;
ТабДок.ОриентацияСтраницы = ОриентацияСтраницы.Портрет;
ТабДок.ПолеСлева = 10;
ТабДок.ПолеСправа = 10;
ТабДок.ПолеСверху = 12;
ТабДок.ПолеСнизу = 12;
ТабДок.АвтоМасштаб = Истина;
ТабДок.ПовторятьПриПечатиКолонки = ТабДок.Область(, 1, , 1);
ТабДок.ПовторятьПриПечатиСтроки = ТабДок.Область(1, , 2, );
ТабДок.ДвусторонняяПечать = ТипДвустороннейПечати.Нет;
ТабДок.ЭкземпляровНаСтранице = 1;
ТабДок.ЧередованиеРасположенияСтраниц = ЧередованиеРасположенияСтраниц.НеИспользовать;
ТабДок.ТочностьПечати = ТочностьПечати.Точная;
Сообщить(ТабДок.ШиринаСтраницы = 148);
Сообщить(ТабДок.ВысотаСтраницы = 210);
Сообщить(ТабДок.ПовторятьПриПечатиКолонки.Лево = 1);
Сообщить(ТабДок.ПовторятьПриПечатиКолонки.Право = 1);
Сообщить(ТабДок.ПовторятьПриПечатиСтроки.Низ = 2);
Возврат ТабДок;
КонецФункции
&НаСервереБезКонтекста
Функция УчебнаяТаблица()
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Область(, 1, , 1).ШиринаКолонки = 35;
ТабДок.Область(, 2, , 2).ШиринаКолонки = 10;
ТабДок.Область(, 3, , 3).ШиринаКолонки = 14;
ТабДок.Область(, 4, , 4).ШиринаКолонки = 15;
Заголовок = ТабДок.Область(1, 1, 1, 4);
Заголовок.Объединить();
Заголовок.Текст = "Учебная таблица — данные только в памяти";
Заголовок.Шрифт = Новый Шрифт("Arial", 12, Истина);
Заголовок.ЦветФона = Новый Цвет(230, 242, 255);
Заголовок.ВысотаСтроки = 24;
ТабДок.Область(2, 1).Текст = "Товар";
ТабДок.Область(2, 2).Текст = "Количество";
ТабДок.Область(2, 3).Текст = "Цена";
ТабДок.Область(2, 4).Текст = "Сумма";
Товары = Новый Массив;
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Книга", 3, 250));
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Ручка", 1, 50));
НомерСтроки = 3;
Итого = 0;
Для Каждого Товар Из Товары Цикл
ТабДок.Область(НомерСтроки, 1).Текст = Товар.Название;
Значения = Новый Массив;
Значения.Добавить(Товар.Количество);
Значения.Добавить(Товар.Цена);
Значения.Добавить(Товар.Количество * Товар.Цена);
Для НомерКолонки = 2 По 4 Цикл
Ячейка = ТабДок.Область(НомерСтроки, НомерКолонки);
Ячейка.СодержитЗначение = Истина;
Ячейка.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Ячейка.Значение = Значения.Получить(НомерКолонки - 2);
Ячейка.Формат = "ЧДЦ=2; ЧН=0";
КонецЦикла;
Итого = Итого + Товар.Количество * Товар.Цена;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;
ПодписьИтога = ТабДок.Область(5, 1, 5, 3);
ПодписьИтога.Объединить();
ПодписьИтога.Текст = "Итого";
Итог = ТабДок.Область(5, 4);
Итог.СодержитЗначение = Истина;
Итог.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Итог.Значение = Итого;
Итог.Формат = "ЧДЦ=2; ЧН=0";
Все = ТабДок.Область(2, 1, 5, 4);
Все.Шрифт = Новый Шрифт("Arial", 10);
Граница = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1, Ложь);
Все.Обвести(Граница, Граница, Граница, Граница);
Возврат ТабДок;
КонецФункции
Разбор по шагам
ВысотаСтраницы и ШиринаСтраницы используются для Custom, единицы — миллиметры. Ориентация задана явно.
Повторяются колонка A и первые две строки. Для маленькой таблицы эффект повторения может быть не виден, если результат занимает одну страницу.
АвтоМасштаб подбирает масштаб вывода; ТочностьПечати относится к точности печатного представления.
Отключены двусторонняя печать и чередование сторон. Физическая печать не запускается: показ документа — отдельная операция.
Как проверить результат
Пять проверок дают Истина.
Через настройки страницы собственного документа проверьте Custom и поля. Только предварительный просмотр; команду Печать для упражнения не нажимайте.
Ожидаемый результат
Явные параметры маленькой страницы без отправки заданий печати.
На что обратить внимание
Поддержка нестандартной бумаги и печатные поля зависят от драйвера. Пример не подтверждает реальную печать.
Количество копий на странице — не число экземпляров всего задания печати.
Первые две строки повторяются для этого учебного документа; в другом макете координаты шапки могут отличаться.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.