Указывает тип вывода отчета, производимого ReportListener.


ReportListener.ListenerType [= iExpr]

Возвращаемое значение

Целочисленное (Integer).

В приведенной ниже таблице перечислены значения распознаваемые Visual FoxPro.

Стандартные значения ListenerType	Итоговый вывод
-1	(Используется по умолчанию) Представляет собой базовое состояние абстрактного класса ReportListener. Он не осуществляет вывода.
0	ReportListener просчитывает (render - смотри секцию "термины и толкование" данной статьи) вывод - страницу за страницей, посылая события рендеринга драйверу принтера.
1	ReportListener просчитывает все страницы отчета и, затем, делает итоговые страницы доступными новому Xbase компоненту, ссылка на который хранится в системной переменной _REPORTPREVIEW. Для этого значения ListenerType не производится никаких действий, в случае если нет доступного объекта, определяемого переменной _REPORTPREVIEW.
2	ReportListener просчитывает вывод страницу за страницей, но не посылает их на принтер. Вы можете использовать вывод, с помощью кода, размещаемого в метода OutputPage, который вызывается по готовности каждой страницы в процессе рендеринга.
3	ReportListener просчитывает все страницы сразу, но не вызывает явно приложение, определяемое системной переменной _REPORTPREVIEW. Вы можете использовать вывод, с помощью кода, размещаемого в метода OutputPage, после завершения рендеринга, вызывая метод OutputPage для передачи инструкций ReportListener'у о посылке страницы на выбранное вами устройство вывода.

Приложение Report Output добавляет некоторые, определенные пользователем результаты рендеринга в исходный набор вывода. Однако, использование этих значений не препятствуют получению, одновременно с вашими, и стандартного для Visual FoxPro итогового вывода из одного и того же объекта ReportListener, в соответствии с "родными" значениями для ListenerType перечисленными выше. Для получения более подробной информации смотри статью Свойство OutputType (Visual FoxPro).

Вызов приложения Report Output Application с дополнительными параметры	Итоговый вывод
4	ReportListener предоставляет в качестве вывода XML файл. По умолчанию, значение его свойства ListenerType установлено в -1 (не производить вывода). Вы можете, кроме того, установить значение его свойства ListenerType в одно из стандартно поддерживаемых значения, для производства двух типов вывода одновременно.
5	ReportListener предоставляет в качестве вывода HTML файл, и необязательный вспомогательный файл картинки. По умолчанию, его свойство ListenerType установлено в -1 (не выдавать стандартный вывод). Вы можете, кроме того, установить значение его свойства ListenerType в одно из значений, поддерживаемых по определению разработчиков (natively), для одновременного производства двух типов вывода.

Вызов приложения Report Output Application с дополнительными параметры

Итоговый вывод

ReportListener предоставляет в качестве вывода XML файл. По умолчанию, значение его свойства ListenerType установлено в -1 (не производить вывода). Вы можете, кроме того, установить значение его свойства ListenerType в одно из стандартно поддерживаемых значения, для производства двух типов вывода одновременно.

ReportListener предоставляет в качестве вывода HTML файл, и необязательный вспомогательный файл картинки. По умолчанию, его свойство ListenerType установлено в -1 (не выдавать стандартный вывод). Вы можете, кроме того, установить значение его свойства ListenerType в одно из значений, поддерживаемых по определению разработчиков (natively), для одновременного производства двух типов вывода.

Примечания

Применяется к : объекту ReportListener.

Report Engine поставляет значение свойства ListenerType приложению Report Output Application, когда вы используете опцию OBJECT TYPE <N> в команде REPORT FORM , или когда вы устанавливаете SET REPORTBEHAVIOR 90, показывая, что вы желаете использовать объектно-ассистированное исполнение отчета для всех последующих команд REPORT FORM. Приложение Report Output Application сохраняет регистрационную запись для классов ReportListener, используемых по умолчанию, чтобы обслуживать присущие (native) ListenerType значения, и кроме того два дополнительных значения OutputType, добавляемых его собственной Visual Foxpro библиотекой классов или любые другие, предложенные вами. Для получения более подробной информации смотри статью Приложение Report Output.

Ваши, производные от ReportListener, классы могут обслуживать множество типов итогового вывода, с помощью поддержки множества значений свойстваListenerType. Вы можете использовать метод SupportsListenerType для оценки свойства ListenerType property во время исполнения отчета, и определять, должен ли производный класс производить какие-либо действия.

Вы можете зарегистрировать единственный класс, как обработчик, который должен использоваться по умолчанию, для множества типов вывода с помощью приложения Report Output. Приложение Report Output Application присваивает значение, получаемое им от движка отчетов VFP парному свойству OutputType вашего, производного от ReportListener, объекта. Ваш класс может динамически определять для использования корректное значение ListenerTyp, основанное на получаемом им значении свойства OutputType и на его собственной способности обслуживать различные итоговые выводы.

Например, приложение Report Output Application предоставляет UpdateListener, фундаментального класса ReportListener User Feedback, в качестве обработчика, который может быть использован по умолчанию для обработки множества стандартных значений свойства ListenerType. При инициализации, UpdateListener имеет свойство ListenerType установленным в значение "минус единицы" -1 (не производить вывода). Он проверяет значение свойства OutputType для определения - какой ListenerType он должен иметь для каждой исполняемой вами команды REPORT FORM.

Пример

Следующий код заимствован из метода OutputType_assign базового фундаментального класса ReportListener Base Foundation Class, класса, из которого происходит UpdateListener. Код проверяет, находится ли величина, полученная как OutputType среди поддерживаемых классом значение ListenerType, и присваивает значение свойству ListenerType если это так.

	Скопировать код
IF THIS.SupportsListenerType(THIS.OutputType) THIS.ListenerType = THIS.OutputType ENDIF

Смотри также

Справочное руководство

Свойства, методы и события объекта ReportListener
Команда REPORT FORM

Прочие ресурсы

Свойства (Visual FoxPro)
Справочное руководство по языку (Visual FoxPro)
Фундаментальные классы ReportListener

Термины и толкование:
rendering - применительно к отчетам Visual FoxPro, представляет собой процесс внутреннего просчета отчета на основе данных заданной вами раскладки элементов отчета и привязки к элементам отчета полей таблиц или вычисляемых выражений, в результате которого мы получаем сформированный вывод, размещаемой в буфере. В процессе просчета происходят события, которые могут быть посланы драйверу принтера. При этом вовсе не обязательно наличие графического вывода конечного результата процесса на экран монитора, как это происходит, например, в графических программах. Итоговый сформированный вывод может сразу отправлен на принтер, или использован вспомогательными приложениями обработки вывода отчетов.

Термины и толкование:

rendering - применительно к отчетам Visual FoxPro, представляет собой процесс внутреннего просчета отчета на основе данных заданной вами раскладки элементов отчета и привязки к элементам отчета полей таблиц или вычисляемых выражений, в результате которого мы получаем сформированный вывод, размещаемой в буфере. В процессе просчета происходят события, которые могут быть посланы драйверу принтера. При этом вовсе не обязательно наличие графического вывода конечного результата процесса на экран монитора, как это происходит, например, в графических программах. Итоговый сформированный вывод может сразу отправлен на принтер, или использован вспомогательными приложениями обработки вывода отчетов.