Приложение ReportBuilder.App использует внутреннюю Регистрационную Таблицу, с помощью которой  определяется требуемый Класс Обработчика, который создается для соответствующих Событий EventType и объектов Отчета report object (которые определяют текущую выборку записей из курсора FRX рассматриваемого отчета, которые описывают либо Контрол Отчета, либо Полосу Отчета, либо Заголовок Отчета и так далее (объект Отчета). Структура Таблицы Регистрации представлена далее:

Остальные дополнительные поля, существующие в рассматриваемой Таблице игнорируются Построителем Отчетов.

Классы, определяемые в Таблице Регистрации, могут быть одного из следующих Типов:

Классы Обработчика Событий могут быть порождены любым базовым классом Visual FoxPro, но должны осуществлять программный интерфейс (API) с указанным Обработчиком Event Handler API. Упомянутый программный интерфейс Event Handler API имеет следующие признаки:

• Должен содержать Метод м именем "Execute", который должен принимать один параметр - ссылку на Объект (которым является передаваемый в класс объект обработки).

В том случае, если указанный выше метод обработки Объекта Execute( oEvent )не определен в вашем Классе, Обработчик Событий должен устанавливать соответствующие Флаги возвращаемых значений, как приводится в примере, фрагменте программного Кода:

	Копировать Код
DEFINE CLASS MyHandler AS Custom PROCEDURE Execute( oEvent ) * You can alter oEvent.returnFlags to suit oEvent.SetHandledByBuilder(.T. | .F. ) oEvent.SetReloadChanges( .T. | .F. ) ENDPROC ENDDEFINE

Рассматриваемый Метод получает ссылку на Объект, в котором произошло Событие, требующее обработки. Обработчик установить требуемое значение Флага в возвращаемую переменную ReturnFlags и определить необходимое действие, которое должен выполнить Дизайнер Отчетов для рассматриваемого Объекта после того, как управление будет возвращено из рассматриваемого Класса.

Обработчик Событий:

• Определяет значение для поля REC_TYPE = "H".

• Определяет общий принцип обработки для конкретной комбинации данного типа события + типа объекта отчета.

Дополнительную информацию по использованию необходимых Свойств и выполнения Метода  Execute() смотрите в разделе: Класс Событий Построителя Отчетов.

Класс Фильтра может быть порожден одним из базовых классов Visual FoxPro и обязан осуществлять соответствующий программный интерфейс  Event Handler API (смотрите выше), дополнительно, в этом классе Фильтра, должно быть создано свойство с именем  allowToContinue:

	Копировать Код
DEFINE CLASS MyFilter AS Custom allowToContinue = .T. PROCEDURE Execute( oEvent ) * decide whether or not to process the event THIS.allowToContinue = .T. * You can optionally alter oEvent.returnFlags to suit oEvent.SetHandledByBuilder(.T. | .F. ) oEvent.SetReloadChanges( .T. | .F. ) ENDPROC ENDDEFINE

Класс Фильтра Обработчика Событий:

• Определяет значение поля в Таблице Регистрации REC_TYPE = "F".

• Обрабатывает каждое событие Построителя Отчетов.

• Осуществляет обработку потока событий согласно приоритетам, заданным в поле FLTR_ORDR.

• Может прервать дальнейшую обработку поступаемых Событий, для этого устанавливается значение Свойства AllowToContinue = False (.F.)

• Может выполнить предварительную обработку исходного  курсора FRX до начала обработку поступившего События в рассматриваемый класс обработчика Событий.

Класс Обработчика Завершения (Exit Handler class) должен поддерживать программный интерфейс:  API-интерфейс Обработчика Событий.

Класс Обработчика типа Exit:

• Определяет значение поля REC_TYPE = "X".

• В основном используется для выполнения специального программного Кода в момент завершения обработки События (clean-up time).

• Данный класс выполняется только в том случае, когда выполнены (обработаны) все текущие События с помощью Обработчика Event Handler. Если класс Фильтра обработчика прерывает выполнение текущего цикла обработки, то рассматриваемый класс Завершения (Exit) не будет выполнен.

• Как и любые рассматриваемые классы, данный Класс может изменять или уточнять значения флагов завершения получаемого по ссылке объекта события oEvent.ReturnFlags. Но данная практика не является рекомендуемой, класс предназначен для других целей.

Вы можете заменить стандартно установленный диалоговый бокс определения требуемого Выражения GETEXPR,для этого требуется определить соответствующий объект в Таблице Регистрации, для записи которого устанавливается значение поля REC_TYPE="G". Создаваемый Класс обработчика должен содержать "замещающий" Метод с именем GetExpression(). К примеру, как показано в следующем фрагменте программного Кода:

	Копировать Код
DEFINE CLASS MyGetExpr AS Custom PROCEDURE GetExpression( cDefExpr, cDataType, cCalledFrom, oEvent ) LOCAL cExpression GETEXPR TO cExpression DEFAULT cDefExpr RETURN cExpression ENDPROC ENDDEFINE

Только один "замещающий" Класс для перехвата стандартного класса обработки требуемого выражения GetExpressionWrapper может быть определен в вашей Таблице Регистрации. Если будет создано несколько записей со значением поля REC_TYPE="G," то только первая найденная Запись будет использоваться как описание "замещающего" класса обработки События Построителя Отчетов.

Описание параметра cCalledFrom

Вы можете заменить стандартный Диалоговый бокс, который активируется при нажатии кнопки Edit settings (Изменение установок), которая размещена в группе командных кнопок Run-time extensions (Расширения Режима выполнения Отчета) , расположенной в закладке Other Построителя Отчетов; в этом случае создается соответствующая запись в Таблице Регистрации со значением поля REC_TYPE = "E". Создаваемый класс должен поддерживать требования, описанные в разделе: Event Handler API. Если создаваемый класс представляет собой Форму, то последняя должна быть модальной (MODAL window).

Рассматриваемый "замещающий" класс должен содержать Метод с именем Execute(), который выполняет следующие операции:

• Читает метаданные в формате XML из соответствующего поля STYLE.

• Обеспечивает необходимый интерфейс для пользователя по редактированию указанных метаданных.

• Сохраняет измененные метаданные в формате XML в указанном поле STYLE.

• В отличие от рассмотренных выше Классов Обработчика Событий, данный метод не может устанавливать соответствующие значения Флагов возвращаемых значений (ReturnFlags).

Только один "замещающий" класс с типом "Е" может быть создан в Таблице Регистрации для стандартного класса RuntimeExtensionEditor. Если вы создаете несколько классов Редактора с типом = "E", то будет обработана только первая найденная запись указанной Таблицы.

Вы можете добавить новую Закладку в Контейнер Multiple Selection, диалоговый бокс (Построитель Отчетов), для этого  существует возможность создания нового класса в Таблице Регистрации Обработчика Событий, для записей которых устанавливается признак REC_TYPE  = "M".

Указанный класс должен порождаться базовым классом Page Object. Если указанный класс будет содержать внутренние объекты типа  Container Object,  тогда должны быть созданы соответствующие Методы с именами .LoadFromFrx() и .SaveToFrx(), которые могут быть вызваны из различных мест рассматриваемого Диалогового Бокса множественного выбора; например, как описывается в следующем фрагменте программного Кода:

Копировать Код

DEFINE CLASS pagAlign AS page Caption = "Alignment" Name = "pagAlign" ADD OBJECT Panel1 AS panelAlign ENDDEFINE DEFINE CLASS panelAlign as Container BorderWidth = 0 Width = 300 Height = 300 Event = null frxCursor = null ADD OBJECT Check1 AS Checkbox WITH ; Caption = "Align to leftmost object", ; Top = 100, Left = 50, Width = 150, Value=.F. PROCEDURE LoadFromFrx() * No initialization required RETURN .T. ENDPROC PROCEDURE SaveToFrx() IF THIS.Check1.Value LOCAL curSel curSel = SELECT() SELECT MIN(hpos) AS hpos FROM frx ; WHERE curpos AND objcode<>53 ; INTO CURSOR query newHpos = query.hpos USE IN query SELECT frx SCAN FOR curpos AND RECNO()>1 REPLACE hpos WITH m.newHpos ENDSCAN SELECT (m.curSel) ENDIF RETURN .T. ENDPROC ENDDEFINE

В представленном Примере, создается дополнительная Закладка в Диалоговом боксе множественного выбора, в которой размещается один управляющий Контрол-переключатель (CheckBox) который, если он является отмеченным, выполняет горизонтальное размещение всех выделенных (выбранных) объектов текущего Отчета относительно самого левого объекта из выделенных (другими словами - стандартное выравнивание по левому краю).

Рассматриваемый контейнерный объект должен обеспечивать следующие программные компоненты для удовлетворения полного программного интерфейса:

• Метод LoadFromFrx()вызывается в процессе инициализации рассматриваемой Формы (диалогового бокса), поэтому является удобным местом для размещения программного Кода определения начальных значений переменных или других необходимых действий.

• Метод SaveToFrx() вызывается в момент нажатия пользователем кнопки OK (при закрытии рассматриваемого диалогового бокса). Выполните возврат значения, = FALSE, если вам требуется не закрывать данный диалоговый бокс.

• Если определено, то Свойство с именем Event может содержать ссылку на соответствующий Объект построителя Отчетов, событие которого требует обработки. (Дополнительную информацию смотрите в разделе: Класс Событий Построителя Отчетов.)

• Если определено, Свойство с именем frxCursor может содержать соответствующую ссылку на объект frxCursor (для удобства дополнительной обработки событий данного объекта). (Дополнительную информацию смотрите в разделе: FRX Cursor, фундаментальный класс.)

В том случае, когда вы создаете несколько записей в Таблице Регистрации с указанным выше признаком дополнительной Закладки (REC_TYPE="M"), то для каждого созданного класса, загруженного в рассматриваемый Диалоговый бокс, создается отдельная независимая Закладка в общем контейнере.

Когда Построитель Отчета запущен, дизайнер отчета передает идентификатор (ID) типа события вместе с копией соответствующего файла  FRX, открытого в приватной сессии данных. Объект отчета, к которому относится рассматриваемое Событие, обычно идентифицируется указателем Записи в соответствующем курсоре FRX. Сначала построитель отчета запрашивает значения полей OBJTYPE и OBJCODE из выбранной записи, а после этого (с помощью соответствующей ссылки) обращается в Таблицу регистрации Обработчика.

Относительно объектов Множественного Выбора:

По-умолчанию, регистрационная Таблица обработчика событий содержит регистрационную запись типа MultiSelectHandler, для которой установлено свойство  OBJTYPE = 99. Дополнительную информацию и пример об обработчике множественного выбора смотрите в разделе: Multiple Selection, диалоговый бокс (Построитель Отчетов).

Построитель Отчетов определяет момент выделения нескольких объектов (контролов) среди общего множества объектов Отчета и обрабатывает выделенное подмножество с уникальным идентификатором OBJTYPE:

	Копировать Код
COUNT FOR curpos AND RECNO() > 1 TO oEvent.SelectedObjectCount IF oEvent.SelectedObjectCount > 1 oEvent.OBJTYPE = 99 oEvent.OBJCODE = 0 ELSE oEvent.OBJTYPE = frx.OBJTYPE oEvent.OBJCODE = frx.OBJCODE ENDIF

Таким образом, заданный Класс обработчика Событий зарегистрирован как обработчик Множественного Выбора.

Задачи

Описание

Концепции

Другие ссылки