Метод табличного документа ПроверитьВывод()
Объект ТабличныйДокумент имеет метод ПроверитьВывод(), предназначенный для того, чтобы проверить, поместится ли список областей на текущую страницу. В случае если метод вернет значение Истина, вывод областей, переданных в метод, не приведет к созданию новой страницы, иначе, для того, чтобы вывести области, в табличном документе будет создана новая страница. Данный метод работает с учетом настроек печати документа, у которого вызывается метод.
Рассмотрим пример. Пусть нам необходимо создать отчет "Платежная ведомость". Требуется, чтобы на первой странице был заголовок, отображающий информацию о ведомости в целом, на остальных страницах - заголовок, содержащий только шапку таблицы ведомости. В подвалах страницы необходимо иметь информацию о сумме по странице. В подвале последней страницы необходимо иметь итоговую информацию по всей ведомости.
Для того чтобы реализовать подобный отчет нам потребуется использовать метод ПроверитьВывод(). Пример алгоритма отчета будет выглядеть так:
1. выводим в результирующий табличный документ область - заголовок первой страницы;
2. для каждой строки из ведомости:
2.1. проверяем, вмещается ли на текущую страницу область со строкой ведомости и область итога по странице;
2.2. если области помещаются на странице - выводим строку области;
2.3. иначе - выводим подвал страницы, выводим горизонтальный разделитель страницы, выводим шапку страницы, выводим строку ведомости;3. выводим подвал отчета.
Ниже приведен пример того, как подобный алгоритм может быть реализован на встроенном языке 1С:Предприятия 8:
СтрокаСПодвалом = Новый Массив; // создадим массив для проверки вывода
СтрокаСПодвалом.Добавить(ОбластьДетальныхЗаписей);
СтрокаСПодвалом.Добавить(ПодвалСтраницы);
ИтогПоСтранице = 0;
ТабДок.Вывести(ОбластьЗаголовок); // выведем заголовок отчета
ТабДок.Вывести(ОбластьШапкаТаблицы); // выведем шапку страницы
Пока ВыборкаДетали.Следующий() Цикл // по всем строкам, которые необходимо вывести
ОбластьДетальныхЗаписей.Параметры.Заполнить(ВыборкаДетали); // заполним параметры области табличного докуента
Если Не ТабДок.ПроверитьВывод(СтрокаСПодвалом) Тогда
// Строка с итогом не вмещается.
ПодвалСтраницы.Параметры.Сумма = ИтогПоСтранице; // установим итог по странице
ТабДок.Вывести(ПодвалСтраницы); // выведем итог по странице
ТабДок.ВывестиГоризонтальныйРазделительСтраниц(); // начнем новую страницу
ТабДок.Вывести(ОбластьШапкаТаблицы); // выведем шапку страницы
ИтогПоСтранице = 0; // сбросим текущую сумму по странице
КонецЕсли;
ТабДок.Вывести(ОбластьДетальныхЗаписей); // выведем очередную строку
ИтогПоСтранице = ИтогПоСтранице + ВыборкаДетали.Сумма; // увеличим итог по странице
КонецЦикла;
ПодвалСтраницы.Параметры.Сумма = ИтогПоСтранице; // установим итог по странице
ТабДок.Вывести(ПодвалСтраницы); // выведем итог по странице
ТабДок.Вывести(ОбластьПодвал); // выведем подвал отчета
Метод табличного документа ПроверитьПрисоединение()
Метод табличного документа ПроверитьПрисоединение() работает аналогично методу ПроверитьВывод(), с тем отличием, что данный метод проверяет, изменится ли количество страниц по горизонтали при выводе в отчет областей при помощи метода Присоединить().