Происходит (так указано в оригинале, хотя было бы вернее указать "вызывается" - примечание переводчика), когда ReportListener готов предоставить вывод элемента раскладки в отчете или этикетке.

oReportListener.Render(nFRXRecNo,;
                       nLeft,nTop,nWidth,nHeight,;
                       nObjectContinuationType, ;
                       cContentsToBeRendered, GDIPlusImage)

Параметры

nFRXRecno

Указывает номер записи в файле определения отчета или этикетки (frx или lbx), описывающей элемент раскладки, который будет визуализирован (rendered).

nLeft

Указывает координаты колонки, в единицах 1/960 дюйма (960 dpi), прямоугольника на текущей странице, в котором вхождение этого элемента раскладки будет визуализировано (rendered).

nTop

Указывает координату строки, в единицах 1/960 дюйма (960 dpi), прямоугольника на текущей странице, в котором вхождение этого элемента раскладки будет визуализировано (rendered)

nWidth

Указывает ширину , в единицах 1/960 дюйма (960 dpi), прямоугольника на текущей странице, в котором вхождение этого элемента раскладки будет визуализировано (rendered)

nHeight

Указывает высоту , в единицах 1/960 дюйма (960 dpi), прямоугольника на текущей странице в которой вхождение этого элемента раскладки будет визуализировано (rendered)

nObjectContinuationType

Указывает current continuation state (текущее состояние продолжения - перенос элемента раскладки на последующие страницы) визуализируемого объекта. Когда элементы раскладки объединяют страницы, они визуализируются во множестве секций (однократно для каждой страницы).

Замечание
Продолжение может произойти для элементов раскладки типа Expression (Field), Shape или Line. Хотя элементы раскладки типа Label и Picture могут захватывать полосы в отчете, они не могут захватывать страницы и ReportListener визуализирует их только один раз. Не все типы полос поддерживают захват страниц. Обратитесь к описании Полосы (Bands) отчета для получения более подробной информации.

Приведенная ниже таблица перечисляет возможные значения для параметра nObjectContinuationType.

 

Значение	Тип продолжения
0	Завершено (нет продолжения на последующих страницах).
1	Имеется начало элемента раскладки, незавершенного на текущей странице.
2	Середина элемента, не начатого и незавершенного на текущей странице.
3	Конец элемента, завершенного на текущей странице.

cContentsToBeRendered

Указывает текст для визуализации элементов раскладки Expression (Field) и Label. Для элементов раскладки Picture, собранных из файла, cContentsToBeRendered содержит имя файла.

При указании имени файла картинки, ReportListener предоставляет cContentsToBeRendered в виде DBCS строки, что является стандартным форматом для строки в Visual FoxPro. Однако, при указании текста для визуализации, ReportListener предоставляет cContentsToBeRendered в виде Unicode строки, соответствующим образом транслированную в корректную локаль с помощью любой информации регионального скрипта, связанную с этим элементом раскладки в записи файла определения отчета (frx).

Если предоставляемый вами класс посылает текстовое значение через некоторую дополнительную обработку, такую как сохранение в таблице, вы можете использовать функцию STRCONV() и его необязательный параметр регионального скрипта, для первичного преобразования в DBCS строку. Для получения более подробной информации смотрите описание функции STRCONV( ).

Замечание

Вы можете установить для отчета региональный скрипт в качестве скрипта по умолчанию, воспользовавшись диалоговым окном Report Properties (Свойства отчета). Для получения более подробной информации смотрите описание  Закладка Page Layout диалогового окна Report Properties (Свойства отчета) (Report Builder - Компоновщика отчета). Кроме того, вы можете указать установку регионального скрипта для индивидуальных элементов раскладки, при выборе прочих атрибутов шрифта. Для получения более подробной информации смотрите описание задачи Как: изменить установки шрифта для элементов управления отчетa.

GDIPlusImage

Предоставляет дескриптор GDI+ графики, когда элемент раскладки Picture собирается из картинки, получаемой не на основе файла, а на основе содержимого поля  General или элемента управления Image.

Когда ReportListener визуализирует различные типы элементов раскладки, или когда вы не установили значение его свойства SendGDIPlusImage в 1 или большее значение, то тогда этот параметр имеет значение 0. Для получения более подробной информации смотрите описание свойства.

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

Примечания

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

ReportListener вызывает однократно метод Render для каждого вхождения каждого элемента раскладки, который должен быть визуализирован или, возможно, множество раз для одного и того же типа элемента раскладки, захватившего несколько страниц.

Замечание
Во время обработки отчета, в случае если вы используете выражение Print When на элементе раскладки, Report System оценивает это выражение с целью принятия решения - должно ли появляться каждое вхождение элемента раскладки. Если Print When оценивается в False (.F.) для конкретного вхождения объекта раскладки, то элемент не появляется и ReportListener не вызывает метод Render.

Замечание

Если Print When оценивается в True (.T.), вы можете изменить визуализированное содержание некоторых элементов раскладки с использованием AdjustObjectSize и EvaluateContents (например, изменить текст Expression элемента управления в раскладке в строку нулевой длины, или сделать ее прозрачной). В результате такого действия, вы можете не видеть никакого результата визуализации в выводе отчета. Однако, ReportListener продолжит в этой ситуации вызывать метод Render.

Специальные возможности визуализации Visual FoxPro GDI+

Объекты ReportListener используют Microsoft Windows GDI+ для визуализации устройств вывода. GDI+ позволяет осуществлять вывод аппаратно-независимым (device-independent), что означает, что используется один и тот же механизм визуализации как при просмотре содержимого отчета, его печати или его сохранении в файл картинки.

ReportListener exposes some special features of GDI+, которые дают вам возможность настроить визуализацию текста. Например, свойство DynamicLineHeight объекта ReportListener позволяет вам использовать GDI+ динамическое изменение расстояния между строками (dynamic line-spacing) для визуализации текста. ReportListener, кроме того позволяет использовать опции GDI+ StringTrimming, которые позволяют вам определить - как визуализируется текст, когда он не вмещается в пространство, отведенное вами для элемента expression в раскладке отчета. Для получения более подробной информации смотрите DynamicLineHeight Property и Using GDI+ in Reports.

Пример

Некоторые параметры могут применяться лишь к некоторым типам элементов раскладки. Вы можете использовать первый параметр, nFRXRecno, для проверки файла определения отчета (frx) и определить тип элемента раскладки. Затем вы можете соответствующим образом дополнить процесс метода Render для текущего типа элемента.

Приведенный ниже пример аналогичен коду, используемому фундаментальным классом ReportListener XML Display-Style для копирования картинок, хранящихся в файлах на диск, когда ReportListener визуализирует их. Он использует параметр nFRXRecNo для выяснения типа элемента раскладки. Если тип элемент представляет собой Picture, то он проверяет параметр cContentsToBeRendered с целью выяснить - доступен ли файл для копирования. Затем он откладывает выполнение кода родного класса для продолжения визуализации картинки в стандартном устройстве вывода.

Скопировать код

PROCEDURE Render(nFRXRecNo,; nLeft,nTop,nWidth,nHeight,; nObjectContinuationType, ; cContentsToBeRendered, GDIPlusImage) LOCAL llCopyImage, lcFile IF THIS.CopyImageFilesToExternalFileLocation THIS.SetFRXDataSession() GO nFRXRecNo IN FRX IF FRX.ObjType = FRX_OBJTYP_PICTURE AND ; FRX.Offset # FRX_PICTURE_SOURCE_GENERAL AND ; FILE(cContentsToBeRendered) llCopyImage = .T. ENDIF THIS.SetCurrentDataSession() ENDIF IF llCopyImage lcFile = FORCEPATH(cContentsToBeRendered, ; FULLPATH(THIS.ExternalFileLocation, ; ADDBS(JUSTPATH(THIS.TargetFileName)))) IF NOT FILE(lcFile) COPY FILE (cContentsToBeRendered) TO (lcFile) ENDIF ENDIF DODEFAULT(nFRXRecNo,; nLeft,nTop,nWidth,nHeight,; nObjectContinuationType, ; cContentsToBeRendered, GDIPlusImage) ENDPROC

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