Определяет независимость поддержки объектом ReportListener получения различных типов Отчетов.

? oReportListener.SupportsListenerType(iListenerType)

Параметры

iListenerType

Определяет Тип внутреннего Механизма получения Отчета с использованием объекта ReportListener.

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

Логического типа.

Возвращается значение =  True (.T.), если передаваемый параметр определяет поддерживаемый Тип получения (конвертации) Отчета.

Expand imageКомментарии

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

Объект типа  ReportListener не порождает Исключительную ситуацию (ошибку), если пользователь указывает тип ListenerType, который не поддерживается системой; просто в данном случае пользователь не получает никаких результатов. Вам рекомендуется поддерживаться описанной Стратегии при проектировании пользовательских объектов, производных от данного Класса. Переопределение программного кода Метода SupportsListenerType должно обеспечивать соответствующее поведения данного объекта, без генерации Сообщения об Ошибке.

Производные объекты от класса ReportListener могут использовать только допустимые внутренние типы получаемых Отчетов (только поддерживаемые форматы). Например, вы можете получить сначала Изображение всех страниц Отчета, в режиме Предварительного просмотра, а только после этого выполнять реальную печать на Принтере. Работу данного сценария обеспечивают только типы  ListenerType =  1 или 3, только два этих значения Типов обеспечивают сначала получение Изображения, а потом печать с помощью OutputPage. Данный класс возвращает значение = False (.F.),  для типов Отчетов ListenerType = -1, 0 или 2. Данные значения типов ListenerType не поддерживают кеширование изображений Страниц Отчета, и не могут быть использованы при получении многофункциональных Отчетов.

NoteПримечание

Сморите раздел: ListenerType, свойствоy о возможных, поддерживаемых значениях типа Отчетов ListenerType. В указанном разделе имеется также пример использования Метода SupportsListenerType.

Методы Объектов, производных от класса ReportListener не обязательно возвращают значения =  True (.T.) для других значений Типов Отчетов, которые могут быть определены в Приложениях получения Отчетов (Report Output Application). Данный класс "опционально" поддерживает перечисленные значения внутренних типов ListenerType  (от 0 - до 3), для использования представленного функционала Отчетов рекомендуется использовать другие значения для Типов ОтчетовOutputType, которые будут обрабатываться соответствующим приложением  Report Output Application, данные значения могут определять альтернативные варианты получения Отчетов.

Например, фундаментальный класс ReportListener HTML Foundation Class поддерживает все внутренние типы ListenerType, и не добавляет новых значений типов. Данный класс обеспечивает альтарнативный вариант получения Отчетов, и не переопределяет существующие типы Отчетов ListenerType и не использует метод SupportsListenerType. Поэтому, вы можете без помех использовать данный класс HtmlListener для просмотра результатов своих Отчетов (в соответствующем формате HTML), использую перечисленные выше значения типов ListenerType. Дополнительную информацию смотрите в разделе: OutputType, свойство (Visual FoxPro).

Expand imageПример

В представленном далее Примере, рассматриваемый метод направляет нестандартное значение = 99, которое обрабатывается объектом типа ReportListener. На данное значение вы получаете  результат = False (.F.), потому, что объект ReportListener не поддерживает указанный тип Отчета. Далее, передается значение типа = 2, возвращается результат =  True (.T.), данный тип Отчета Listenertype - поддерживается.

 CopyCode imageКопировать Код
LOCAL loReportListener
loReportListener = CREATEOBJECT("ReportListener")
? loReportListener.SupportsListenerType(99)
* displays: .F.
? loReportListener.SupportsListenerType(2)
* displays: .T.

Expand imageСм. также