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

Механизм условного оформления

Данный механизм предназначен для обеспечения необходимого оформления областей отчета с заданным условием. Механизм предоставляет следующие возможности:

• применение оформления к отчету целиком,
• применение оформления к определенному полю отчета.,
• применение оформления к группировке отчета,
• применение оформления к полю в группировке отчета,
• установка условия, при выполнении которого будет применяться оформление,
• описание оформления, которое будет применяться к области отчета.

Описание условного оформления

Для применения условного оформления необходимо определить следующие его элементы:

• область, к которой применяется оформление,
• условие, при выполнении которого применяется оформление,
• описание оформления.

Рассмотрим подробнее составляющие условного оформления.


Область, к которой применяется оформление

Описание области, к которой применяется оформление, состоит из списка элементов областей. Каждый элемент области отчета состоит из имени поля отчета, и типа области: поле или группировка. В случае если данный список пуст, оформление применяется ко всей области данных отчета. Если область содержит как поля, так и группировки, то оформление будет применяться только к полям, которые принадлежат указанным группировкам. В случае если описание области содержит только элементы - поля, оформление будет применяться только к указанным полям. В случае если описание области содержит только группировки, оформление применяется ко всей области группировки, за исключением областей вложенных группировок и областей детальных записей. Для оформления области детальных записей, необходимо добавить в описание области группировку с пустым именем.

Условие, при выполнении которого применяется оформление

Для указания условия, при выполнении которого применяется оформление, используется объект Отбор. Данный объект содержит список полей с условиями, которые применяются к полям. 

Описание оформления

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

• ЦветТекста - цвет текста оформляемой области отчета,
• ЦветФона - цвет фона оформляемой области отчета,
• Шрифт- шрифт оформляемой области отчета,
• Формат - формат значений, выводимых в область отчета,
• ГоризонтальноеПоложение - положение текста в ячейках отчета по горизонтали, 
• ВертикальноеПоложение- положение текста в ячейках отчета по вертикали,
• ОриентацияТекста - угол наклона текста в оформляемой области отчета, 
• Отступ - отступ от начала ячейки в оформляемой области отчета, 
• АвтоОтступ - отступ от начала ячейки, зависящий от уровня, в оформляемой области отчета, 
• ВыделятьОтрицательные - необходимость выделения отрицательных значений, выводимых в отчет, 
• Текст - текст, который будет выводиться в оформляемую область отчета.

Программный доступ к условному оформлению построителя отчета

Программный доступ к условному оформлению осуществляется через свойство построителя отчета УсловноеОформление. Данное свойство содержит описание условного оформления, которое применяется к отчету.


Интерактивное редактирование условного оформления

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


Примеры использования условного оформления

Пример использования условного оформления можно найти в демонстрационной конфигурации "Примеры ИТС", в отчете "ПродажиНоменклатуры". В данном отчете выводится отчет о продажах номенклатуры контрагентам. В отчете, при помощи условного оформления, зеленым фоном выделяются суммы, если их значения превышали 10000, желтым фоном выделяются строки номенклатуры, если объем продаж по данной номенклатуре превысил 30000, красным текстом в отчете выделяются строки, содержащие услуги.

Пример интерактивной настройки условного оформления можно посмотреть в том же отчете, в форме настройки отчета, на закладке "Оформление". При выполнении отчета данную форму можно вызвать, воспользовавшись кнопкой командной панели отчета "Настройка...".