Данное свойство определяет текущий номер выполняемого запроса по обработке данных для рассматриваемого объекта Отчета в целях получения (вычисления) требуемых результирующих значений, например,  общего количества Листов Отчета: _PAGETOTAL.

ReportListener.CurrentPass

Expand imageЗначение Свойства / Возвращаемое значение

Целого типа, Integer.

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

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

Объект типа ReportListener определяет значение другого свойства TwoPassProcess после выполнения События BeforeReport. В зависимости от этого устанавливается значение рассматриваемого свойства CurrentPass  (или =0, или =1), смотрите ниже. В зависимости от значений указанных свойств Объекта Отчета выполняются соответствующие операции в следующем событии: BeforeBand.

Значение свойства CurrentPass также используется при выполнении стандартных команд Отчетов: LABEL / REPORT FORM. Значение рассматриваемого свойства не очищается во время выполнения текущего Отчета, поэтому вы можете определить, как выполнялся данный Отчет, за Один или Два прохода обработки Данных. В отличие от вышесказанного, значение свойства переопределяется: TwoPassProcess = .F., после завершения выполнения Отчета, выполняемый объект ReportListener по-прежнему предполагает значение = .T., поэтому вам требуется выполнять прямые команды восстановления начальных значений при повторном выполнении Отчета.

Дополнительную Информацию об использовании рассмотренных Свойств внутренними механизмами Подсистемы Отчетов (Report System) смотрите в следующем разделе:  Основные понятия Объектно-Ассистированных Отчетов в Visual FoxPro.

В таблице приводятся допустимые значения для рассматриваемого свойства CurrentPass.

Значения Краткое Описание

0

Значение "по-умолчанию" при создании нового экземпляра Объекта ReportListener. Значение свойства вычисляется во время выполнения Объектом Отчета каждого Прохода обработки данных, количество которых определяется другим свойством объекта ReportListener (TwoPassProcess = .T.). Данное значение не изменяется в период от начала выполнения Отчета - до полного его Завершения в том случае, когда TwoPassProcess = .F..

1

Данное значение указывает, что выполняется Второй, завершающий Проход обработки Данных Отчета, при этом предполагается, что: TwoPassProcess = .T..

Expand imageСм. также