В DELPHI/LAZARUS/LAZARUS на странице палитры компонентов QReport расположено около двух десятков компонентов, применяемых для построения отчетов. Основным компонентом является TQuickRep, определяющий поведение отчета в целом. Другие компоненты определяют составные части отчета.
TQRBand - заготовка для расположения данных, заголовков, титула отчета и др.» отчет, в основном, строится из компонентов TQRBand, которые реализуют:
область заголовка отчета;
область заголовка страницы;
область заголовка группы;
область названий столбцов отчета;
область детальных данных, предназначенную для отображения данных самого нижнего уровня детализации;
область подвала группы;
область подвала страницы;
область подвала отчета.
TQRSubDetail - определяет область, в которой располагаются данные подчиненной таблицы при реализации в отчете связи Master-Detail на основе существующей связи между ТБД;
TQRGroup - применяется для группировок данных в отчете;
TQRLabel - позволяет разместить в отчете статический текст;
TQRDBText - позволяет разместить в отчете содержимое поля набора данных;
|
|
TQRExpr - применяется для вывода значений, являющихся результатом вычисления выражений, алгоритм вычисления выражений строится при помощи редактора формул данного компонента;
TQRSysDate - служит для вывода в отчете даты, времени, номера страницы, счетчика повторений какого-либо значения и т.д.;
TQRMemo - служит для вывода в отчете содержимого полей комментариев;
TQRRichText - служит для вывода в отчете содержимого полей форматированных комментариев;
TQRDBRichText - служит для вывода в отчете содержимого полей форматированных комментариев, источником которых является поле набора данных;
TQRShape - служит для вывода в отчете графических фигур, например, прямоугольников;
TQRImage - служит для вывода в отчете графической информации, источником которой является поле набора данных;
TQRChart - служит для встраивания в отчет графиков
Компонент TQuickRep определяет поведение и характеристики отчета в целом. При размещении этого компонента в форме в ней появляется сетка отчета. В дальнейшем в этой сетке располагаются составные части отчета, например, группы TQRBand.
Перечислим важнейшие свойства, методы и события компонента TQuickRep.
Свойство property Bands: TQuickRepBands;
состоит из множества логических значений (False/True), которые определяют включение в отчет отдельных видов составляющих:
HasColumnHeader - заголовка столбцов отчета;
HasDetail - детальной информации;
HasPageFooter - подвала страницы;
HasPageHeader - заголовка страницы;
HasSummary - подвала отчета;
HasTitle - заголовка отчета.
Свойство property DataSet: TDataSet; указывает на набор данных, на основе которого и создается отчет. Обычно для выдачи отчета используется один НД.
|
|
Если нужно вывести связанную информацию из нескольких таблиц БД, ее объединяют в одном НД при помощи оператора SELECT. В этом случае в качестве НД для отчета может использоваться компонент TQuery. Информацию из нескольких связанных НД можно включать в отчет, если эти наборы данных связаны в приложении отношением Master-Detail. В этом случае в качестве НД отчета указывается Master-набор, а ссылка на соответствующие Detail-наборы осуществляется в компонентах TQRSubDetail.
Если в отчет нужно включить информацию из несвязанных наборов данных, применяют композитный отчет, то есть отчет, составленный из группы других отчетов.
Свойство property Frame: TQRFrame; определяет параметры рамки отчета:
• Color - цвет линии рамки;
• DrawBottom - определяет, следует ли выводить линию снизу;
• DrawLeft- определяет, следует ли выводить линию слева;
• DrawRight- определяет, следует ли выводить линию справа;
• Draw Top- определяет, следует ли выводить линию сверху;
• Style - определяет стиль линии;
• Width - определяет ширину линии в пикселях.
Свойство property Page: TQRPage; определяет параметры страницы.
Свойство property PrinterSettings: TQuickRepPrinterSettings; определяет параметры принтера.
Свойство property PrintIfEmpty: Boolean; у казывает (True), что следует печатать отчет даже в том случае, если он не - содержит данных.
Методы
procedure NewPage; в ыполняет переход на новую страницу. Может использоваться в обработчиках событий компонентов отчета BeforePrint или AfterPrint и не может - в обработчиках событий OnPrint, OnStartPage и OnEndPage.
procedure Preview; выводит отчет в окно предварительного просмотра.
Чтобы во время разработки отчета просмотреть в окне предварительного просмотра содержимое отчета в том виде, как он будет выводиться на печать, необходимо:
· выбрать отчет при помощи мыши;
· нажать правую кнопку мыши;
· во всплывающем меню выбрать элемент Preview.
Следует заметить, что при этом не будут видны некоторые данные, например, значения вычисляемых полей наборов данных. Они будут выводиться только во время выполнения.
Методы:
procedure Print; печатает отчет на принтере.
procedure PrinterSetup; обеспечивает установки параметров принтера.
События:
property AfterPrenew: TQRAfterPreviewEvent; наступает после закрытия окна предварительного просмотра отчета.
property AfterPrint: TQRAfterPrintEvent; наступает после вывода отчета на печать.
property BeforePrint: TQRBeforePrintEvent; наступает в момент генерации отчета, до выдачи окна предварительного просмотра отчета и до вывода отчета на печать.
property OnEndPage: procedure(Sender: TObject); наступает в момент подготовки к генерации последней страницы отчета.
property OnStartPage: procedure(Sender: TObject); наступает в момент подготовки к генерации первой страницы отчета.
Компоненты TQRBand являются основными составными частями отчета и используются для размещения в них статического текста и данных. Месторасположение компонента в отчете и его поведение определяются свойством property BandType: TQRBandType;
Ниже перечислены возможные значения этого свойства:
• rbTitle • определяет компонент заголовка отчета. Информация, размещенная в компоненте TQRBaftd, располагается перед всеми другими частями отчета. Этот вид компонента TQRBand используется для вывода заголовочной информации отчета.
• rbPageHeader - онределяет компонент заголовка страницы. Информация, размещенная я компоненте с этим значением свойства BandType, выводится всякий раз пр» печати новой страницы отчета прежде всех иных частей отчета (но после информации, размещенной в компоненте заголовка отчета - для первой страницы).
• rbDetail - компонент детальной информации. Выводится всякий раз при переходе на новую запись в НД отчета. Отчет печатается для всех записей НД, определяемого свойством отчета DataSet, начиная с первой записи и заканчивая последней. Позиционирование на первую запись и последовательный перебор записей в НД осуществляется компонентом TQnickRep автоматически.
|
|
• rbPageFooter - компонент подвала страницы. Выводится для каждой страницы отчета после всех иных данных на странице.
• rbSummary - компонент подвала отчета. Выводится на последней странице отчета после всей иной информации, но перед подвалом последней страницы отчета
• rbGroupHeader - компонент заголовка группы. Применяется при группировках информации в отчете. Выводится всякий раз при выводе новой группы.
• rbGroupFooter - компонент подвала группы. Применяется при группировках информации в отчете. Выводится всякий раз при окончании вывода группы, после всех данных группы.
• rbSubDetail - компонент для выдачи детальной информации из подчиненного набора данных, при выводе в отчете информации из двух или более наборов данных, связанных в приложении при помощи механизма Master-Detail. Это значение присваивается компоненту автоматически, когда генерируется компонент TQRBand при размещении в форме компонента TQRSubDetail. Программа не должна устанавливать это значение в свойство BandType.
• rbColumnHeader - компонент для размещения заголовков столбцов. Размещается в отчете на каждой странице после заголовка страницы.
• rbOverlay - используется для совместимости с более ранними версиями отчетов.
Свойство property Enabled: Boolean; указывает, печатается в отчете (True) или нет (False) информация, содержащаяся в компоненте TQRBand.
Свойство property ForceNewPage: Boolean; указывает, должна ли информация в составе TQRBand всегда печататься с новой страницы (True) или нет (False).
Событие property BeforePrint: TQRBeforePrintEvent; наступает перед печатью информации, размещенной в области компонента TQRBand.