Объектная модель RDC

Оценить
(0 голоса)

Как уже упоминалось ранее в этом разделе, RDC фактически состоит из четырех различных компонентов, которые могут существовать в вашем VB-приложении: конструктора ActiveX, библиотеки времени выполнения, компонента Report Viewer и компонента Embeddable Report Designer (вовсе необязательно, что все эти объекты будут присутствовать в кажДом проекте). При работе над отчетом в Visual Basic вы либо создаете его в окне проектирования ActiveX, либо предоставляете пользователям возможность самостоятельно сформировать отчет с помощью компонента Embeddable Report Designer и передать объект Report компоненту Report Viewer. По сути дела, библиотека времени выполнения Library является средним звеном, управляющим настройкой отчета.

Использование объекта отчета конструктора ActiveX

Первое, что нужно сделать — это присвоить переменной объекта Visual Basic определение отчета окна проектирования, как показано ниже:

Public Report As New dsrXtreme

В этом фрагменте кода, который взят из модуля modXtreme приложения-примера Xtreme Orders, dsrXtreme — это имя, присвоенное объекту конструктора ActiveX в диалоговом окне Property, a Report — имя объекта, посредством которого можно будет ссылаться на отчет. Поскольку этот объект объявлен в модуле как Public, он будет доступен в пределах всего приложения. Впоследствии, когда нужно будет отобразить отчет в Report Viewer, объект Report будет передан свойству ReportSource компонента Report Viewer. Следующий фрагмент кода взят из события f rmViewer Form Load:

CRViewerl.ReportSource = Report

Здесь CRViewerl — это имя, присваиваемое по умолчанию компоненту Report Viewer (это имя не заменяется другим именем). Объект Report передается свойству ReportSource, поэтому компонент Report Viewer знает о том, какой именно отчет необходимо отобразить.

Суть всего программирования интеграции RDC сводится к использованию библиотеки RDC (RDC Library) между описанием объекта Report и присвоением его Report Viewer. После того, как конструктор будет присвоен переменной объекта Report, вся объектная модель будет доступна для изменения и настройки отчета. Используя объектную модель RDC, которая представлена объектами, коллекциями, свойствами, методами и событиями, вы получите широкие возможности для управления характеристиками, влияющими на поведение отчета во время выполнения.

Когда вы включаете RDC в свой отчет, то в него автоматически добавляется также и библиотека CRAXDRT Library (CRAXDRT — Crystal Repbrts ActiveX Designer Run Time). Этот COM-интерфейс предлагает полный набор свойств и методов, которые можно определять во время выполнения. Чтобы просмотреть имеющиеся в этой библиотеке объекты, коллекции, свойства и методы, воспользуйтесь доступным в Visual Basic компонентом Object Browser (Браузер объектов). Вы можете отобразить окно Object Browser (рис. 25.11) в Visual Basic в любое время, когда ваша программа не выполняется. Чтобы сделать это, просто нажмите клавишу <F2> или выберите в меню View (Вид) пункт Object Browser. Затем, чтобы просмотреть библиотеку доступных в RDC объектов, в первом выпадающем списке появившегося окна Object Browser выберите значение CRAXDRT.

Рис. 25.11. Диалоговое окно Object Browser

Хотя обширное объяснение технологии СОМ и ее общего подхода к объектной модели и иерархии объектов можно найти в документации Microsoft, навигация по объектной модели RDC вскоре станет для вас вторым “я”. На самом верхнем уровне в иерархии объектов расположен объект Application — все остальные объекты будут находиться ниже его. Вообще говоря, существование объекта Application в RDC предполагается по умолчанию, поэтому вам не нужно ссылаться на него явным образом (если только вы не используете RDC без окна проектирования отчета конструктора ActiveX). Объектом наиболее высокого уровня, с которым вам чаще всего придется иметь дело, является объект Report.

Объектная модель RDC

Совет. Если вы используете Embeddable Report Designer для того, чтобы предоставить своим конечным пользователям возможность проектировать отчет в интерактивном режиме, вам понадобится комбинированная библиотека времени выполнения/времени проектирования, CRAXDDRT. Отыщите ее в окне Object Browser, чтобы просмотреть доступные в ней объекты, коллекции, свойства и методы. Компонент Embeddable Report Designer более подробно будет рассматриваться далее в этой главе.

 

Использование внешнего файла .RPT
Введение в объектную модель RDC
Предоставление удостоверения для подключения к базе данных
Предоставление данных удостоверения для подотчетов
Управление выборкой записей

Добавить комментарий


Защитный код
Обновить