Опис класів TRaveXXX

Робота із звітами Rave Report в режимі RunTime

Звиходом Delphi 7 ми стали свідками виходу нового генератора звітів Rave Report Borland Edition від розробників фірми Nevrona. Середовище розробки Rave має досить багато нововведень, і в теж час ряд помилок і недоліків. Серед позитивних якостей можна відзначити: збереження проекту звіту у файл і читання його з файлу, що дозволяє зручно завантажити або зберегти необхідний проект звіту, і надалі працювати з ним. Також є набір компонентів для конвертації звіту Rave в інші формати (PDF, HTML, RTF, TEXT). Rave Report значно полегшує розробку звітів де використовуються бази даних

Дослідження класів в проекті звіту Rave Report

Дляроботи із звітами в RunTime буде потрібно, знання імен модулів, що підключаються, в розділ uses, створюваного проекту. Нижче представлена таблиця опису основних модулів, які можуть знадобитися для роботи із звітом Rave в RunTime.

Примітка: Для розробників CLX застосувань назва модулів майже ідентично, тільки в імені модуля передує символ "Q". Наприклад: QRvCsBars. Всі модулі знаходяться в каталозі "\Rave5\Lib" куди встановлено середовище програмування Delphi 7.

Ім'я модуля	Опис модуля
RvClass	Цей модуль містить реалізацію базових класів
RvProj	У цьому модулі набір класів що реалізовують власне сам проект звіту і що відповідають за роботу з ним
RvCsDraw	Класи в цьому модулі реалізують графічні примітиви
RvCsBars	У цьому модулі реалізовані штрихові коди
RvCsStd	У цьому модулі реалізуються основні елементи оформлення звіту
RvCsRpt, RvCsData	Набір класів в даному модулі служить для виведення даних з баз даних або інших джерел даних

Слід розділяти поняття проект звіту і звіт як такий окремо. Проект звіту - може містити в собі цілу колекцію окремих звітів. Звіт - це набір сторінок, елементів оформлення, елементів доступу до різних джерел даних і тому подібне, те, що підготовлене або готується для друку звіту.

Опис класів TRaveXXX

У цьому розділі міститься опис класів, з яких в основному складається проект звіту. Проект звіту формують три основні класи: TRaveProjectManager, TRaveReport, TRavePage. Для роботи з джерелами даних можуть використовуватися класи TRaveDataView, TRaveDataField, а так само TRaveRegion і TRaveDataBand. Розберемо ці основні класи конкретніше.

Якописувалося вище, клас TRaveProjectManager забезпечує всю базову роботу з проектом звіту Rave. Здійснює такі основні завдання як: читання/збереження проекту звіту, робота з колекцією звітів і глобальними сторінками, пошук необхідного звіту і компонентів TRaveXXX і багато що інше. Нижче приведений опис основних властивостей класу TRaveProjectManager.

TRaveProjectManager
AdminPassword	Пароль для доступу до проекту звіту *
Categories	Зберігає список найменування категорій. Далі окремому звіту можна вказати тип категорії, що допомагає організувати зручнішу роботу і провести пошук звітів по категоріях
CompileNeeded	Необхідна компіляція (прихований) *
Description	Сюди записується докладніша інформація про компонент
DevLocked	Блокування компоненту від випадкових змін його властивостей
FullName	Альтернативне найменування компоненту

КласTRaveReport. Даним класом є окремий звіт, який є контейнером, що зберігає в собі сторінки звіту. Опис основних властивостей класу TRaveReport приведені нижче.

TRaveReport
AlwaysGenerate	Перед друком звіту заповнює змінні типу TotalPages, щоб їх значення було відоме перед друком першої сторінки
Category	Дозволяє встановити приналежність звіту до заданої категорії. Список доступних категорій задається у властивості "Categories" менеджера звітів TRaveProjectManager
Collate	Визначає тип впорядковування завдання на друк
CompileNeeded	Необхідна компіляція (прихований) *
Copies	Зберігає кількість копій, після друку звіту

Клас TRavePage. Даний клас реалізує сторінку звіту і також є контейнером, в який поміщаються різні елементи оформлення звіту, а також допоміжні не візуальні елементи, наприклад як TRaveFontMaster. Розглянемо властивості класу TRavePage в приведеній нижче таблиці.

TRavePage
Bin	Указується тип лотка для подачі паперу
BinCustom	Якщо в представленому списку Bin немає необхідного типу лотка, то указується призначена для користувача константа лотка, підтримувана принтером
CompileNeeded	Необхідна компіляція (прихований) *
Description	Сюди записується докладніша інформація про компонент

TRaveDataView - даний клас-посередник забезпечує роботу і зв'язок між джерелами даних і звітом (дане призначення класу гадане зважаючи на відсутність довідкової інформації про нього). Описаний він в модулі RvDirectDataView.

TRaveDataView
CompileNeeded	Необхідна компіляція *
ConnectionName	Зберігає ім'я підключеного джерела даних
Description	Сюди записується докладніша інформація про компонент
DevLocked	Блокування компоненту від випадкових змін його властивостей

TRaveDataField - даним класом є поле даних і надає виведення інформації з джерела даних. Цей клас розташований в модулі RvDataField.

TRaveDataField
Calculated	Обчислюване поле чи ні *
Description	Сюди записується докладніша інформація про компонент
DevLocked	Блокування компоненту від випадкових змін його властивостей
FieldName	Ім'я поля
FullName	Альтернативне найменування компоненту
Locked	Блокування компоненту від випадкових змін його властивостей
Name	Ім'я компоненту
NullText	Текст, що виводиться за умовчанням (якщо немає даних в джерелі даних)
Size	Розмір поля

Дата добавления: 2015-10-21