Оглавление (TOC)
Специальный компонент Оглавление (Table of Contents), который предназначен для автоматического формирования оглавления в отчетах. Оглавление может быть создано по различным компонентам и в несколько уровней.
Настройка оглавления осуществляется при помощи:
Редактора компонента, в котором осуществляется выбор компонентов для формирования уровней оглавления;
Списка свойств этого компонента.
Для того чтобы вызвать редактор, следует:
Осуществить двойной щелчок по компоненту Оглавление;
Выделить компонент Оглавление, и в контекстном меню выбрать команду Редактировать (Design);
В редакторе оглавления, представлена иерархия расположения компонентов отчета. По выбранным компонентам будет создано оглавление с учетом логической иерархии. Например, если второй выбранный компонент является компонентом второго уровня по отношению к первому, то и оглавление в данном случае будет заголовком второго уровня.
Поле дерево отчетов, представляет собой иерархию расположения компонентов в отчете;
В поле Выражение (Expression) указывается колонка данных или другое выражение, результаты вычисления которого будут являться значениями для оглавления в отчете.
Пример создания оглавления
Рассмотрим пример создания оглавления для Master-Detail отчета. Для начала необходимо решить Оглавление будет в начале отчета, в конце или в любом другом месте. Соответственно, компонент Оглавление должен располагаться в шаблоне до компонентов отчета, которые формируют сам отчет или после. Допустим, в текущем примере оглавление будет в начале отчета. Компонент Оглавление можно добавить на той же странице шаблона, где располагаются основные компоненты. Однако, предпочтительнее добавить отдельную страницу в шаблоне и на ней расположить компонент Оглавление.
Далее, к примеру, Master-Detail список формируется при помощи бэндов DataBand1 и DataBand2, где DataBand1 - это мастер записи, а DataBand2 - детальные данные. В этом случае, с точки зрения расположения компонентов в отчете, эти бэнды располагаются на одном уровне. Однако, в логической иерархии построения отчетов - DataBand2 является подчиненным по отношению к DataBand1. Соответственно, при формировании оглавления записи DataBand1 будут оглавлением первого уровня, а DataBand2 - второго.
Таким образом, если выделить DataBand1 и DataBand2 в редакторе компонента Оглавление, будет сформировано двухуровневое оглавление в построенном отчете.
Теперь рассмотрим пример добавления оглавления по шагам:
Шаг 1: Открыть отчет, например Master-Detail;
Шаг 2: Определиться с расположением оглавления в отчете. Например, в шаблоне отчета добавим страницу Page2 до основной страницы отчета;
Шаг 3: Добавить компонент Оглавление на эту страницу;
Шаг 4: Вызвать редактор компоненты и выбрать, компоненты по которым следует сформировать оглавление. Например, DataBand1 и DataBand2;
Шаг 5: Изменить выражение. Этот шаг не является обязательным, можно использовать значения по умолчанию;
Шаг 6: Нажать кнопку Ок в редакторе компонента Оглавление.
После этого, открыть отчет на просмотр. Оглавление для отчета будет сформировано автоматически.
Таблица свойств компонента
В таблице представлены наименование и описание свойств компонента Оглавление.
Наименование |
Описание |
Отступ (Indent) |
Предоставляет возможность указать отступ вложенного уровня, по отношению к предыдущему, в иерархии значений оглавления. |
Поля (Margins) |
Группа свойств, которая предоставляет возможность указать отступы значений от границ этого компонента. |
Новая страница до |
Предоставляет возможность вставить пустую страницу в построенном отчете до страницы с оглавлением отчета. Если свойство установлено в значение Да (True), то при построении отчета новая страница будет добавлена до компонента Оглавление. Если же свойство установлено в значение Нет (False), то новая страница не будет добавлена. |
Новая страница после (New Page After) |
Предоставляет возможность вставить пустую страницу в построенном отчете после последней страницы с оглавлением отчета. Если свойство установлено в значение Да (True), то при построении отчета новая страница будет добавлена после компонента Оглавление. Если же свойство установлено в значение Нет (False), то новая страница не будет добавлена. |
Справа налево |
Предоставляет возможность включить режим Справа налево для компонента Оглавление. Если свойство установлено в значение Да (True), то при построении отчета режим Справа налево будет установлен для компонента Оглавление. Если же свойство установлено в значение Нет (False), то будет использоваться режим Слева направо. |
Стили (Style) |
Предоставляет возможность настроить стили оформления для значений каждого уровня иерархии в оглавлении. |
Перенос слов |
Предоставляет возможность включить режим переноса строк для значений оглавления. Если свойство установлено в значение Да (True), то перенос длинных значений оглавления на следующую строку будет осуществляться. Если же свойство установлено в значение Нет (False), то перенос длинных значений оглавления осуществляться не будет. |
Высота |
Предоставляет возможность изменить высоту компонента в режиме редактирования отчета. Однако, при построении отчета высота компонента может вырасти для вывода всего списка значений оглавления отчета. |
Макс. высота |
Предоставляет возможность установить максимальную высоту компонента в режиме редактирования отчета. По умолчанию установлено в значение 0, т.е. максимальная высота не ограничена. |
Мин. высота (Min Height) |
Предоставляет возможность установить минимальную высоту компонента в режиме редактирования отчета. По умолчанию установлено в значение 0, т.е. минимальная высота не ограничена. |
Границы |
Группа свойств, которая предоставляет возможность включить и настроить оформление границ компонента. |
Условия (Conditions) |
Предоставляет возможность вызвать редактор условий. |
Стиль компонента |
Представляет возможность назначить стиль для компонента. |
Использовать стили владельца |
Предоставляет возможность использовать стили владельца, т.е. компонента к которому подчиняется этот компонент, или нет. Если свойство установлено в значение Да (True), то при построении для компонента Оглавление будут применяться стиль владельца. Если же свойство установлено в значение Нет (False), то стиль владельца применяться не будет. |
Доступность (Enabled) |
Предоставляет возможность включить или выключить обработку компонента при построении отчета. Если свойство установлено в значение Да (True), то при построении отчета компонент Оглавление будет обработан и отобразиться в отчете. Если же свойство установлено в значение Нет (False), то компонент Оглавление не будет построен. |
Наименование |
Предоставляет возможность изменить наименование текущего элемента. |
Псевдоним (Alias) |
Предоставляет возможность изменить псевдоним текущего элемента. |
Ограничения (Restrictions) |
Предоставляет возможность настроить права использования текущего элемента на панели индикаторов: Параметр Изменение допускается (Allow Change) предоставляет возможность разрешить или запретить изменение элемента. Если флажок установлен, то текущий элемент можно изменить. Если же флажок не установлен, то этот элемент изменить невозможно. |
Замок (Locked) |
Предоставляет возможность запретить или разрешить изменение размеров и перемещение текущего элемента. Если свойство установлено в значение Да (True), то текущий элемент невозможно будет переместить или изменить его размер. Если же данное свойство установлено в значение Нет (False), то этот элемент переместить и изменить его размеры. |
Связь (Linked) |
Предоставляет возможность привязать текущее местоположение к панели индикаторов или другому элементу. Если свойство установлено в значение Да (True), то текущий элемент привязан к текущему местоположению. Если же данное свойство установлено в значение Нет (False), то этот элемент не привязан к текущему местоположению. |