Тип: Число. Содержит положение верхней границы объекта (в миллиметрах) на странице PDF-документа. Начало координат страницы – левый верхний угол. Если не указано, то объект будет расположен автоматически.
Полное описание, параметры и ограничения
ОписаниеОтображаемогоОбъектаPDF.Верх (PDFRepresentationObjectDescription.Top)
ОписаниеОтображаемогоОбъектаPDF (PDFRepresentationObjectDescription)
Верх (Top)
Доступен, начиная с версии 8.3.18.
Использование:
Чтение и запись.
Описание:
Тип: Число.
Содержит положение верхней границы объекта (в миллиметрах) на странице PDF-документа.
Начало координат страницы – левый верхний угол. Если не указано, то объект будет расположен автоматически.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.18.
Методическая информация
Практические примеры
Открыть свой PDF со штампом для настоящей визуальной проверки
Полный модуль формы получает собственный PDF с сервера, добавляет учебный штамп и открывает именно этот объект без назначения рабочего файла.
Где и как запускать
Полный модуль собственной управляемой формы внешней обработки, толстый клиент Windows 8.5.1.1343.
Подготовка
Создайте отдельную собственную конфигурацию УчебнаяКонфигурацияСинтаксиса и внешнюю обработку с управляемой формой. Команда Выполнить связана с процедурой Выполнить, кнопка вызывает эту команду.
Вставьте полный модуль одного урока на уровне модуля формы, не внутрь существующего обработчика. Серверная функция создаёт собственную таблицу Книга / 3 / 250 / 750 и возвращает настоящие PDF-байты.
Используйте толстый клиент Windows платформы 8.5.1.1343. Серверу необходима возможность экспортировать табличный документ в PDF. Веб-клиент и его расширения этим уроком не проверяются.
Окна имеют префикс guide-owned; закрывайте вручную только эти окна. Показать передаётся пустое имя файла, поэтому рабочий файл для автосохранения не назначается.
Во время асинхронной операции не закрывайте форму и не запускайте второй экземпляр операции. Ждать означает ожидание завершения обещания, а не получение готового документа без ожидания.
Только урок печати требует строковый реквизит формы Подтверждение. Печать разрешается отдельной фразой и обязательным диалогом, в котором пользователь сам выбирает собственное тестовое устройство или отменяет.
При подготовке пособия эти окна и печать в 1С не запускались: проверки структуры не являются доказательством внешнего вида или физического вывода.
Перем СобственныйPDF;
&НаСервереБезКонтекста
Функция СоздатьСобственныеБайтыPDF()
Таблица = Новый ТабличныйДокумент;
Таблица.КодЯзыка = "ru";
Таблица.Область(1, 1).Текст = "СОБСТВЕННЫЙ УЧЕБНЫЙ ОБРАЗЕЦ";
Таблица.Область(2, 1).Текст = "Книга";
Таблица.Область(2, 2).Текст = "3";
Таблица.Область(2, 3).Текст = "250";
Таблица.Область(2, 4).Текст = "750";
Таблица.Область(1, 1, 2, 4).ЦветФона = Новый Цвет(255, 255, 210);
Таблица.Область(, 1, , 1).ШиринаКолонки = 45;
Поток = Новый ПотокВПамяти;
Попытка
Таблица.Записать(Поток, ТипФайлаТабличногоДокумента.PDF);
Данные = Поток.ЗакрытьИПолучитьДвоичныеДанные();
Исключение
Поток.Закрыть();
ВызватьИсключение;
КонецПопытки;
Возврат Данные;
КонецФункции
&НаКлиенте
Функция ПрочитатьСобственныйДокумент(Данные)
Поток = Данные.ОткрытьПотокДляЧтения();
Попытка
Документ = Новый ДокументPDF;
Документ.Прочитать(Поток);
Поток.Закрыть();
Исключение
Поток.Закрыть();
ВызватьИсключение;
КонецПопытки;
Возврат Документ;
КонецФункции
&НаКлиенте
Функция СоздатьСобственныйШтамп()
ТаблицаШтампа = Новый ТабличныйДокумент;
ТаблицаШтампа.КодЯзыка = "ru";
ТаблицаШтампа.Область(1, 1).Текст = "ОБРАЗЕЦ — НЕ ДОКУМЕНТ";
ТаблицаШтампа.Область(1, 1).ЦветФона = Новый Цвет(210, 240, 255);
Описание = Новый ОписаниеОтображаемогоОбъектаPDF;
Описание.Имя = "guide-owned-stamp";
Описание.Объект = ТаблицаШтампа;
Описание.НомерСтраницы = 1;
Описание.Лево = 10;
Описание.Верх = 45;
Описание.Ширина = 60;
Описание.Высота = 10;
Возврат Описание;
КонецФункции
&НаКлиенте
Процедура Выполнить(Команда)
Данные = СоздатьСобственныеБайтыPDF();
СобственныйPDF = ПрочитатьСобственныйДокумент(Данные);
Если СобственныйPDF.КоличествоСтраниц() = 0 Тогда
ВызватьИсключение "Нет собственной страницы для штампа";
КонецЕсли;
Первая = СобственныйPDF.Страницы.Получить(0);
Если Первая.Ширина < 80 Или Первая.Высота < 65 Тогда
ВызватьИсключение "Собственная страница меньше учебного прямоугольника";
КонецЕсли;
Описание = СоздатьСобственныйШтамп();
СобственныйPDF.ДобавитьОтображаемыйОбъект(Описание, Истина);
СобственныйPDF.Показать("guide-owned: Книга и учебный штамп", "");
КонецПроцедурыРазбор по шагам
Вызвать серверную функцию, которая создаёт только собственную таблицу. Получить двоичные данные через клиент-серверную границу.
Прочитать PDF в клиентский объект и проверить наличие и размеры первой страницы. Поток чтения закрывается.
Добавить собственный табличный штамп с номером страницы 1 и координатами в мм.
Сохранить объект в переменной модуля формы и вызвать Показать с собственным заголовком и пустым именем файла.
Как проверить результат
Открывается окно guide-owned: Книга и учебный штамп. Видны Книга, 3, 250, 750 и синий штамп ОБРАЗЕЦ — НЕ ДОКУМЕНТ.
Проверьте первую страницу и читаемость текста вручную. При закрытии не должен предлагаться заранее заданный рабочий путь из этого кода.
Ожидаемый результат
Есть полный образец ручной проверки собственного PDF в интерфейсе, а не вывод о внешнем виде по размеру файла.
На что обратить внимание
Показать открывает интерфейс и не подтверждает, что пользователь действительно прочитал страницу.
Пустое имя файла не запрещает пользователю самостоятельно воспользоваться Сохранить; это отсутствие заданного пути, не режим безопасности.
Штамп не является электронной подписью. Не заменяйте свою таблицу рабочим счётом, договором или документом.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Добавить учебный штамп на первую страницу PDF
У собственного одностраничного PDF размещаем табличный штамп. Координаты и размеры заданы в миллиметрах, номера страниц начинаются с единицы.
Где и как запускать
Серверная процедура отдельной учебной базы; собственный PDF и потоки в памяти.
Подготовка
Используйте отдельную учебную базу. Фрагмент без директив вставьте в тело серверной процедуры ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи.
Все исходные байты создаются самим примером в памяти. Файлы, сеть, справочники и документы не нужны.
Запускайте задачи отдельно. После закрытия ЧтениеДанных/ЗаписьДанных не используйте этот экземпляр повторно.
Документ PDF строится из собственной ячейки Книга: 3 шт. Внешний PDF, установленный PDF-редактор, криптографический сертификат и реальные персональные данные не нужны.
Файловый путь нигде не используется. Для просмотра в PDF-программе сохраните только полученные собственные двоичные данные в отдельно выбранный новый учебный файл.
Чтение = Неопределено;
Запись = Неопределено;
ПотокЧтения = Неопределено;
ПотокPDF = Новый ПотокВПамяти;
Документ = Новый ТабличныйДокумент;
Документ.Область("A1").Текст = "Книга: 3 шт.";
Документ.Область("A1").ЦветТекста = Новый Цвет(30, 90, 180);
Попытка
Документ.Записать(ПотокPDF, ТипФайлаТабличногоДокумента.PDF);
Штамп = Новый ТабличныйДокумент;
Штамп.Область("A1").Текст = "УЧЕБНЫЙ ОБРАЗЕЦ";
ОписаниеШтампа = Новый ОписаниеОтображаемогоОбъектаPDF;
ОписаниеШтампа.Объект = Штамп;
ОписаниеШтампа.Имя = "УчебныйШтамп";
ОписаниеШтампа.НомерСтраницы = 1;
ОписаниеШтампа.Лево = 20;
ОписаниеШтампа.Верх = 30;
ОписаниеШтампа.Ширина = 60;
ОписаниеШтампа.Высота = 12;
Сообщить(ОписаниеШтампа.Объект = Штамп);
Сообщить(ОписаниеШтампа.Имя = "УчебныйШтамп");
Сообщить(ОписаниеШтампа.НомерСтраницы = 1);
Сообщить(ОписаниеШтампа.Лево = 20 И ОписаниеШтампа.Верх = 30);
Сообщить(ОписаниеШтампа.Ширина = 60 И ОписаниеШтампа.Высота = 12);
ПотокPDF.Перейти(0, ПозицияВПотоке.Начало);
Запись = Новый ЗаписьPDF(ПотокPDF);
Запись.ЗаписатьОтображаемыйОбъект(ОписаниеШтампа);
Запись.Закрыть();
Запись = Неопределено;
БайтыPDF = ПотокPDF.ЗакрытьИПолучитьДвоичныеДанные();
ПотокPDF = Неопределено;
ПотокЧтения = БайтыPDF.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеPDF(ПотокЧтения);
Сообщить(БайтыPDF.Размер() > 0);
Сообщить(Чтение.ПолучитьВложения().Количество() = 0);
Исключение
Если Чтение <> Неопределено Тогда
Чтение.Закрыть();
КонецЕсли;
Если Запись <> Неопределено Тогда
Запись.Закрыть();
КонецЕсли;
Если ПотокЧтения <> Неопределено Тогда
ПотокЧтения.Закрыть();
КонецЕсли;
Если ПотокPDF <> Неопределено Тогда
ПотокPDF.Закрыть();
КонецЕсли;
ВызватьИсключение;
КонецПопытки;
Если Чтение <> Неопределено Тогда
Чтение.Закрыть();
КонецЕсли;
Если Запись <> Неопределено Тогда
Запись.Закрыть();
КонецЕсли;
Если ПотокЧтения <> Неопределено Тогда
ПотокЧтения.Закрыть();
КонецЕсли;
Если ПотокPDF <> Неопределено Тогда
ПотокPDF.Закрыть();
КонецЕсли;Разбор по шагам
ОписаниеОтображаемогоОбъектаPDF содержит объект штампа и его размещение, но не рисует его до вызова записи.
НомерСтраницы=1 означает первую страницу. Начало координат — левый верхний угол, Лево/Верх/Ширина/Высота в миллиметрах.
ЗаписатьОтображаемыйОбъект получает всё описание. Имя объекта отличает его от имени файла или вложения.
Повторное чтение подтверждает пригодность итоговых байтов к открытию; внешний вид проверяется отдельно в PDF-программе.
Как проверить результат
Семь сравнений Истина при успешном изменении; вложений нет, штамп не является вложением.
Для визуальной проверки сохраните собственные БайтыPDF в новый учебный файл и проверьте штамп на первой странице, примерно 20 мм справа и 30 мм вниз. Этот показ автоматически не выполняется.
Ожидаемый результат
В собственный PDF записано отображение учебного табличного штампа.
На что обратить внимание
Несуществующая страница вызывает исключение; не начинайте нумерацию с 0.
Такой штамп не является электронной подписью и не удостоверяет юридическую подлинность документа.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.