Внешняя компонента печати PDF (Native Win 32/64)

Общее описание

Отлично подходит для печати прикрепленных файлов в формате PDF, а также печатных форм, есть возможность загрузки PDF из двоичных данных, позволяет показывать диалог печати с установкой диапазона страниц и количества копий или же задавать принтер и диапазон страниц непосредственно в вызове.

Для подключения компоненты используются стандартные методы УстановитьВнешнююКомпоненту() на Клиенте в синхронном режиме, ПодключитьВнешнююКомпоненту() на Сервере или на Клиенте в синхронном режиме, и НачатьУстановкуВнешнейКомпоненты() и НачатьПодключениеВнешнейКомпоненты() на Клиенте в асинхронном режиме вызовов.

Перед началом работы на стороне клиента в асинхронном режиме необходимо вызвать установку компоненты:

НачатьУстановкуВнешнейКомпоненты(ОбработчикРезультата, АдресКомпоненты);

Далее необходимо ее подключить и можно вызывать ее методы:

НачатьПодключениеВнешнейКомпоненты(ОбработчикРезультата, АдресКомпоненты, "PrintPDF");

Примерный код использования компоненты на стороне Клиента в асинхронном режиме может выглядеть так:

Перем мКомпонента;

&НаКлиенте
Процедура Печать(Команда)	
	
	Если мКомпонента = Неопределено Тогда
		УстановитьКомпоненту(
			Новый ОписаниеОповещения("ПечатьПродолжение", ЭтотОбъект));
		Возврат;
	КонецЕсли;	
	
	ПечатьПродолжение(Истина, Неопределено);	
		
КонецПроцедуры	

&НаКлиенте
Процедура ПечатьПродолжение(КомпонентаПодключена, ДополнительныеПараметры) Экспорт	
	
	Если НЕ КомпонентаПодключена Тогда
		Возврат;
	КонецЕсли;
	
	Если мКомпонента = Неопределено Тогда
		мКомпонента = Новый("AddIn.PrintPDF.PrintPDFAddInExtension");
	КонецЕсли;		
		
	мКомпонента.НачатьВызовПечать(Новый ОписаниеОповещения("ПечатьЗавершение", ЭтотОбъект), 
		ИмяФайла, Описание, ПоказыватьДиалогПечати, Принтер, Пароль, Страницы);
	
КонецПроцедуры
	
&НаКлиенте
Процедура ПечатьЗавершение(РезультатВызова, ПараметрыВызова, ДополнительныеПараметры) Экспорт	
	
КонецПроцедуры

&НаКлиенте
Процедура УстановитьКомпоненту(ОбработчикРезультата) Экспорт
			
	Обработчик = Новый ОписаниеОповещения("УстановитьКомпонентуЗавершение", ЭтотОбъект, ОбработчикРезультата);
	
	НачатьУстановкуВнешнейКомпоненты(Обработчик, АдресКомпоненты);
	
КонецПроцедуры

&НаКлиенте
Процедура УстановитьКомпонентуЗавершение(ОбработчикРезультата) Экспорт
	
	НачатьПодключениеВнешнейКомпоненты(ОбработчикРезультата, АдресКомпоненты, "PrintPDF");		
	
КонецПроцедуры

Есть возможность вызова компоненты из внешней обработки, чтобы не снимать типовую конфигурацию с поддержки, рабочий код использования компоненты представлен в обработке TestPrintPDF.epf (в обработке отсутствует компонента, поэтому ее нужно загрузить в макет после покупки).

Компонента работает как на x86, так и x86_64 платформах, в режиме Сервера, Тонкого клиента и Веб-клиента (для браузеров Firefox и Chrome), распространяется в виде пакетного файла, который содержит в себе все версии компоненты.

Протестировано на всех версиях платформы, начиная от 8.2.19.130.

Методы:

Печать / Print - основной метод, отправляет файл на печать, возвращает Истину при успешном выполнении и Ложь, если при вызове произошла ошибка

Может вызываться как с передачей имени файла, так и двоичных данных

Параметры при передаче имени файла:
ПутьКФайлу - обязательный, тип "Строка", полный путь к файлу PDF
Описание - обязательный, тип "Строка", описание задания печати
ПоказыватьДиалогПечати - необязательный, тип "Булево", определяет показывать диалог печати или нет, значение по умолчанию - Ложь
ИмяПринтера - необязательный, тип "Строка", имя принтера, на который будет отправлен документ, если не определен, то печать осуществляется на принтер, установленный по умолчанию в система
Пароль - необязательный, тип "Строка", пароль для чтения защищенного PDF-файла
Страницы - необязательный, тип "Строка", диапазоны страниц для печати, разделенные запятыми (например "1,5,6", или "1-3,7-9", или "1,3-5")
Автоповорот - необязательный, тип "Булево"
Копий - необязательный, тип "Число", количество копий
ДвусторонняяПечать - необязательный, тип "Число", режим двусторонней печати:
 0 - использовать настройки принтера (по умолчанию);
 1 - односторонняя печать;
 2 - двусторонняя печать (поворот вверх);
 3 - двусторонняя печать (поворот влево);
Автоцентрирование - необязательный, тип "Булево"
Масштабировать - необязательный, тип "Число", режим масштабирования печати:
 0 - не масштабировать;
 1 - масштабировать по размеру полей принтера (по умолчанию);
 2 - уменьшить до полей принтера;
 3 - заданный масштаб (задается следующим параметром);
Масштаб - необязательный, тип "Число", заданный в процентах масштаб

Параметры при передаче двоичных данных:
Данные - обязательный, тип "ДвоичныеДанные", двоичные данные файла PDF
Описание - обязательный, тип "Строка", описание задания печати
ПоказыватьДиалогПечати - необязательный, тип "Булево", определяет показывать диалог печати или нет, значение по умолчанию - Ложь
ИмяПринтера - необязательный, тип "Строка", имя принтера, на который будет отправлен документ, если не определен, то печать осуществляется на принтер, установленный по умолчанию в система
Пароль - необязательный, тип "Строка", пароль для чтения защищенного PDF-файла
Страницы - необязательный, тип "Строка", диапазоны страниц для печати, разделенные запятыми (например "1,5,6", или "1-3,7-9", или "1,3-5"
Автоповорот - необязательный, тип "Булево"
Копий - необязательный, тип "Число", количество копий
ДвусторонняяПечать - необязательный, тип "Число", режим двусторонней печати:
 0 - использовать настройки принтера (по умолчанию);
 1 - односторонняя печать;
 2 - двусторонняя печать (поворот вверх);
 3 - двусторонняя печать (поворот влево);
Автоцентрирование - необязательный, тип "Булево"
Масштабировать - необязательный, тип "Число", режим масштабирования печати:
 0 - не масштабировать;
 1 - масштабировать по размеру полей принтера (по умолчанию);
 2 - уменьшить до полей принтера;
 3 - заданный масштаб (задается следующим параметром);
Масштаб - необязательный, тип "Число", заданный в процентах масштаб

ВключитьЛог / EnableLog - включает логирование, возвращает Истину при успешном выполнении и Ложь, если при вызове произошла ошибка

Параметры:
ПутьКФайлуЛога - обязательный, тип "Строка", полный путь к файлу лога, доступный для записи в контексте выполнения методов компоненты
Уровень - необязательный, тип "Число", уровень логирования:
 0 - только ошибки (по умолчанию);
 1 - ошибки и предупреждения;
 2 - ошибки, предупреждения и информационные сообщения;
 3 - ошибки, предупреждения, информационные сообщения, отладочная информация;

На данный момент используется только уровень 0 и 2.

Важно

В асинхронном режиме вызовы методов должны выполняться через НачатьВызов, например:

Компонента.НачатьВызовПечать(Новый ОписаниеОповещения("ПечатьЗавершение", ЭтотОбъект), 
		ИмяФайла, Описание, ПоказыватьДиалогПечати, Принтер, Пароль, Страницы);