Создает пустую таблицу с описанием команд печати. Таблица команд печати передается в процедуры ДобавитьКомандыПечати, размещенные в модулях менеджеров объектов конфигурации, которые перечислены в процедуре УправлениеПечатьюПереопределяемый.ПриОпределенииОбъектовСКомандамиПечати.

Синтаксис

Функция СоздатьКоллекциюКомандПечати() Экспорт

Возвращаемое значение

ТаблицаЗначений:

• Идентификатор - Строка - идентификатор команды печати, по которому менеджер печати определяет печатную форму, которую необходимо сформировать. Например, "СчетЗаказ". Для печати нескольких печатных форм можно указывать одновременно несколько их идентификаторов (строкой, через запятую либо массивом строк), например: "СчетЗаказ,ГарантийноеПисьмо". Если необходимо задать количество копий печати для печатной формы, то ее идентификатор нужно продублировать столько раз, сколько копий необходимо сформировать. При этом следует учитывать, что порядок следования печатных форм в комплекте будет соответствовать порядку идентификаторов печатных форм, указанных в этом параметре. Например (2 счета на оплату + 1 гарантийное письмо): "СчетЗаказ,СчетЗаказ,ГарантийноеПисьмо". Идентификатор печатной формы может содержать в себе и альтернативный менеджер печати, если он отличается от указанного в параметре МенеджерПечати, например: "СчетЗаказ,Обработка.ПечатнаяФорма.ГарантийноеПисьмо". В этом примере ГарантийноеПисьмо формируется в менеджере печати Обработка.ПечатнаяФорма, а СчетЗаказ - в менеджере печати, указанном в параметре МенеджерПечати. Для печатных форм, менеджером печати которых является общий модуль "УправлениеПечатью", в качестве идентификатора необходимо указать полный путь к макету. Например, "Документ._ДемоСчетНаОплатуПокупателю.ПФ_MXL_СчетНаОплату".
  • Массив - список идентификаторов команд печати.
• Представление - Строка - представление команды в меню Печать. Например, "Счет на оплату".
• МенеджерПечати - Строка - (необязательный) имя объекта, в модуле менеджера которого располагается процедура Печать, формирующая табличные документы для этой команды. Если печатная форма формируется автоматически по данным печати и макету, то в параметре необходимо указать общий модуль "УправлениеПечатью". Значение по умолчанию - имя модуля менеджера объекта. Например, "Документ.СчетНаОплатуПокупателю".
• ТипыОбъектовПечати - Массив - (необязательный) список типов объектов, для которых предназначена команда печати. Параметр предназначен для команд печати в журналах документов, где требуется проверка передаваемого типа объекта перед вызовом менеджера печати. Если список не заполнен, то при автоматическом создании списка команд печати в журнале документов он заполняется типом объекта, из которого была импортирована команда печати.
• Обработчик - Строка - (необязательный) клиентский обработчик команды, в который необходимо передать управление вместо стандартного обработчика команды Печать. Используется, например, когда печатная форма формируется на клиенте. Формат "<ИмяОбщегоМодуля>.<ИмяПроцедуры>" используется, когда процедура размещена в общем модуле. Формат "<ИмяПроцедуры>" используется, когда процедура размещена в модуле основной формы отчета или обработки, указанной в МенеджерПечати. Например, КомандаПечати.Обработчик = "_ДемоСтандартныеПодсистемыКлиент.ПечатьСчетовНаОплатуПокупателю"; Пример обработчика в модуле формы: // Формирует печатную форму <представление печатной формы>. // // Параметры: // ПараметрыПечати - Структура - сведения о печатной форме. // * ОбъектыПечати - Массив - массив ссылок выбранных объектов. // * Форма - ФормаКлиентскогоПриложения - форма, из которой вызвана // команда печати. // * ДополнительныеПараметры - Структура - дополнительные параметры печати. // Прочие ключи структуры соответствуют колонкам таблицы КомандыПечати, // подробнее см. в функции УправлениеПечатью.СоздатьКоллекциюКомандПечати. // &НаКлиенте Функция <ИмяФункции>(ПараметрыПечати) Экспорт // Обработчик печати. КонецФункции Следует иметь в виду, что обработчик вызывается при помощи метода Вычислить, поэтому в качестве обработчика может выступать только функция. При этом возвращаемое значение функции никак в дальнейшем не используется подсистемой.
• Порядок - Число - (необязательный) Значение от 1 до 100, указывающее порядок размещения команды по отношению к другим командам. Сортировка команд меню Печать осуществляется сначала по полю Порядок, затем по представлению. Значение по умолчанию - 50.
• Картинка - Картинка - (необязательный) Картинка, которая отображается возле команды в меню Печать. Например, БиблиотекаКартинок.ФорматPDF.
• СписокФорм - Строка - (необязательный) Имена форм через запятую, в которых должна отображаться команда. Если параметр не указан, то команда печати будет отображаться во всех формах объекта, где встроена подсистема Печать. Например, "ФормаДокумента".
• МестоРазмещения - Строка - (необязательный) Имя группы формы, в которую необходимо разместить команду печати. Параметр необходимо использовать только в случае, когда на форме размещается более одного подменю "Печать". В остальных случаях место размещения необходимо задавать в модуле формы при вызове метода ПодключаемыеКоманды.ПриСозданииНаСервере.
• ЗаголовокФормы - Строка - (необязательный) Произвольная строка, переопределяющая стандартных заголовок формы "Печать документов". Например, "Настраиваемый комплект".
• ФункциональныеОпции - Строка - (необязательный) Имена функциональных опций через запятую, от которых зависит доступность команды печати.
• УсловияВидимости - Массив - (необязательный) Коллекция условий видимости команды в зависимости от контекста. Условия видимости команды задаются при помощи процедуры ДобавитьУсловиеВидимостиКоманды. Если параметр не задан, команда видна вне зависимости от контекста.
• ПроверкаПроведенияПередПечатью - Булево - (необязательный) Признак необходимости проверки проведенности документов перед печатью. Если выбран хотя бы один непроведенный документ, то перед выполнением команды печати возникает диалог проведения. Для непроведенных документов команда печати не выполняется. Если параметр не указан, то проверка проведенности не выполняется.
• СразуНаПринтер - Булево - (необязательный) Признак необходимости печати документов без предварительного просмотра, сразу на принтер. Если параметр не указан, то при выборе команды печати открывается форма предварительного просмотра "Печать документов".
• ФорматСохранения - ТипФайлаТабличногоДокумента - (необязательный) Применяется для быстрого сохранения печатной формы (без дополнительных действий) в различные форматы, отличные от mxl. Если параметр не указан, то формируется обычный mxl. Например, ТипФайлаТабличногоДокумента.PDF. При выборе команды печати сразу открывается сформированный в формате pdf документ.
• ПереопределитьПользовательскиеНастройкиКоличества - Булево - (необязательный) Признак необходимости отключения в форме ПечатьДокументов механизма сохранения/восстановления выбранного пользователем количества экземпляров на печать. Если параметр не указан, то механизм сохранения/восстановления настроек будет работать при открытии формы. ПечатьДокументов.
• ДополнитьКомплектВнешнимиПечатнымиФормами - Булево - (необязательный) Признак необходимости дополнить комплект документов всеми подключенными к объекту внешними печатными формами (подсистема ДополнительныеОтчетыИОбработки). Если параметр не указан, внешние печатные формы не добавляются в комплект.
• ФиксированныйКомплект - Булево - (необязательный) Признак необходимости блокировки от изменения пользователем состава комплекта документов. Если параметр не указан, то пользователь сможет исключать отдельные печатные формы из комплекта в форме ПечатьДокументов, а также изменять их количество.
• ДополнительныеПараметры - Структура - (необязательный) произвольные параметры для передачи в менеджер печати.
• НеВыполнятьЗаписьВФорме - Булево - (необязательный) Признак необходимости отключения механизма записи объекта перед выполнением команды печати. Используется в исключительных случаях. Если параметр не указан, производится запись объекта в случае, если в форме объекта установлен признак модифицированности.
• ТребуетсяРасширениеРаботыСФайлами - Булево - (необязательный) Признак необходимости подключения расширения для работы с 1С:Предприятием перед выполнением команды. Если параметр не указан, расширение подключаться не будет.

Пример вызова

Результат = УправлениеПечатью.СоздатьКоллекциюКомандПечати()

Доступность

Сервер, Толстый клиент, Внешнее соединение