Позволяет ReportListener определять диапазон страниц вывода.

? oReportListener.IncludePageInOutput(iPage)

Параметры

iPage

Номер страницы, для которой определяется, находится ли она среди обработанных страниц.

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

Логический тип данных.

Возвращает .T. если параметр, который Вы передаете, идентифицирует страницу в текущем наборе страниц, которые будут обработаны.

Замечания

Применяется к: ReportListener Object.

Класс ReportListener использует два RANGE аргумента команды REPORT FORM, чтобы определить возврашаемые значение для этого метода. Эти два аргумента представлены членами объекта CommandClauses: CommandClauses. RangeFrom и CommandClauses. RangeTo.

Однако исходные классы могут поддерживть более тонко определенные диапазоны типа 1-10,16,20 и возвращать различные значения из IncludePageInOutput.

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

Поскольку должен быть обработан полный диапазон, чтобы обеспечить правильные результаты, ReportListener не вызывает этот метод при предварительном проходе при выполнении многопроходного отчета. Однако определённый Вами класс может вызвать этот метод в течение предварительного прохода. Для получения дополнительной информации, см. TwoPassProcess Property.

Если пользователь вызывает печать из предварительного просмотра отчета, страницы, отобранные для печати не обязательно соответствуют результатам IncludePageInOutput. Печатаемые страницы могут быть, заданы пользователем в диалоговом окне PROMPT команды REPORT FORM, или могут быть динамически изменены члены CommandClauses, предназначенные для этой цели: PrintPageCurrent, PrintRangeFrom, и PrintRangeTo. Напечатанные страницы могут быть любым подмножеством полного диапазона страницы вывода. Для получения дополнительной информации, см. CommandClauses Property.

Пример

Следующий пример показывает как объект на основе ReportListener определяет, включена ли страница в вывод.

  Копировать код
PROC IncludePageInOutput(nPageNo)
   LOCAL lInclude
      FOR EACH oRangeObject in THIS.MyRangeCollection
            IF oRangeObject.Includes(nPageNo)
                lInclude = .T.
                EXIT
           ENDIF
      END FOR
   RETURN lInclude
ENDPROC

Смотрите также