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

PROCEDURE Object.EvaluateContents
LPARAMETERS nFRXRecno, oObjProperties

Параметры

Visual FoxPro посылает событию EvaluateContents параметры в порядке, описанном ниже:

nFRXRecno

Целочисленный тип данных (Integer), указывающий номер записи в файле определения отчета или метки (frx or lbx),  в которой описан элемент раскладки, подлежащий визуализации.

oObjProperties

Объекта класса "Empty", члены которого предоставляют значения, существенные для установки атрибутов элемента раскладки типа Expression.

Член oObjProperties	Тип	Использование
reload	Logical, по умолчанию установливается в .F.	Флажок предупреждения для ReportListener, что вами были сделаны изменения. Установите этот параметр в True (.T.), чтобы сообщить ReportListener об изменении любого из редактируемых членов oObjProperties.
text	Character, по умолчанию устанавливается в оцениваемое содержание элемента раскладки типа Expression.	Вы можете изменить это значение для изменения визуализируемого содержания Expression в run time.
value	Variant, только для чтения	Это значение предоставляет вычисленный результат выажений отчета, включая вычисляемые поля перечисленных ниже типов данных: Double (B) Date (D) Float (F) Integer (I) Logical (L) Numeric (N) DateTime (T) Currency (Y) Null (X) Для других типов данных его содержание представляет нулевую строку (""). Выражения, соединенные специальными операторами ";" и "," могут иметь элементы смешанного типа данных  и в этом контексте считаются символьной строкой (тип "C"). Для получения более подробной информации смотрите Укорачивание и соединение выражений.
fontname	Character, устанавливается по умолчанию в шрифт, хранимый в файле таблицы определения отчета или этикетки для этого элемента раскладки.	Вы можете изменить это значение для замены шрифта, используемого для элемента раскладки Expression в run time.
fontstyle, fontsize	Integer,  устанавливается по умолчанию в численные значения стиля и размера шрифта, хранимого в файле таблицы определения отчета или этикетки для этого элемента раскладки.	Вы можете изменить эти значения для замены стиля и размера шрифта этого 0элемента раскладки Expression в run time. Распознает численные значения для oObjProperties.fontstyle, которые документированы в таблице 60FRX.DBF, размещенной в каталоге FILESPEC. Для получения более подробной инфорамции о 60FRX, смотрите описание Таблица структу для табличных файлов (.dbc, .frx, .lbx, .mnx, .pjx, .scx, .vcx).
fillred, fillblue, fillgreen, penred, penblue, pengreen	Integer, допустимые значения лежат в диапазоне от 0 до 255, по умолчанию равны 255, и устанавливаются по умолчанию в значения, хранимые в файле таблицы определения отчета или этикетки, до тех пор, пока значение в таблице было равно минус единице (-1), что определяет to indicate "использовать значения по умолчанию". Если значение в таблице было равно-1, ReportListener замещает реальные значения, предназначенные для использования.	Вы можете изменить эти значения для установки компонентов Red, Blue и Green components цветов заливки и пера для элемента раскладки типа Expression. Для получения более подробной информации смотрите описание задачи Как: изменить цвета в элементах управления отчета. Если для любого свойства цвета были посланы недопустимые или нечисленные значения, они сбрасываются в значения по умолчанию, хранящиеся в таблице определения отчета или этикетки. Ошибки при этом не происходит.
fillalpha	Integer, допустимые значения лежат в диапазоне от  0 до 255, по умолчанию устанавливаются в 0, когда стиль фона является прозрачным и в 255,  когда стиль фона непрозрачный.	Смотрите приведенные ниже примечания для получения информации об использовании alpha-значений элементов раскладки отчета. Если для этого параметра были посланы недопустимые или нечисленные значения, они сбрасываются в значения по умолчанию, как показано на в этом графике. Для получения информации об установки стиля фона отчета (прозрачный и непрозрачный), смотрите описание задачи Как: изменить прозрачность элементов управления отчета.
penalpha	Integer, допустимые значения лежат в диапазоне от  0 до 255 (непрозрачный).	Смотрите приведенные ниже примечания для получения информации об использовании alpha-значений элементов раскладки отчета. Если для этого параметра были посланы недопустимые или нечисленные значения, они сбрасываются в значения по умолчанию, как показано на в этом графике.

Замечание
Microsoft оставляет за собой право, при необходимости, вызывать EvaluateContents для дополнительных элементов раскладки отчета и этикетки и добавлять членов в oObjProperties соответственно для этих дополнительных типов элементов раскладки. Вы можете использовать nFRXRecno для тестирования типа элемента раскладки так, как это показано в коде примера в описании метода Render.

Примечания

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

Visual FoxPro вызывает EvaluateContents в начале обработки полос данных, один раз для каждого элемента типа Expression. Это не гарантируется, что вызов будет единственным; он может быть вызван множество раз для оценки выражений, которые охватывают полосы данных или страницы, если система производства отчетов полагает эти вызовы необходимыми (например, в случае, если выражение включает в себя _PAGENO).

Замечание
Если вы пишите код, стараясь спрогнозировать случай, когда EvaluateContents может быть вызван многократно, имейте в виду, что не все полосы данных поддерживают охват страниц. Посмотрите описание Полосы отчета (Report Bands) для получения более подробной информации.

Совет

Для повышения производительности, Visual FoxPro не вызывает ни AdjustObjectSize, ни EvaluateContents, если он определил, что в ReportListener для этого события не имеется кода. Если вы обычно включаете место для кода или код общего плана в каждое событие, имейте в виду, что для двух этих событий лучше не помещать в них никакого кода, особенно в случае, если уровень класса является абстрактным (то есть никогда не служит для прямого создания образца). Включите код в класс этого уровня только в том случае, когда вы действительно собираетесь использовать эту функциональную возможность. Потеря в производительности для каждого EvaluateContents увеличивает количество текста, который родной ReportListener предоставляет в свойстве члена oObjProperties.text, поэтому это количество текста может варьироваться для каждого вызова.

Вы можете использовать такой метод для изменения разных характеристик элементов раскладки типа. Однако, вы не можете изменить ширину элемента раскладки, поэтому вы должны установливать характеристики шрифта и содержания элемента раскладки Expression держа в уме это ограничение. Если элемент раскладки помечен, как stretch (растягиваемый), то он следует тем же правилам, который следуют элементы и Shape, и Picture, в которых вы делаете установку высоты в событии AdjustObjectSize. Для получения более подробной информации смотрите описание события AdjustObjectSize.

EvaluateContents дает вам средство для изменения значения Alpha (прозрачность) обоих значений - и Pen, и Fill для элемента Expression. Файлы определения отчета и этикетки хранят только RGB (Red, Green, Blue) компонентов значений цвета с единственной установкой для "opaque" или "transparent." Используя EvaluateContents, вы можете предоставить большее количество цветовых эффектов прямым управлением значения Alpha.

Совет
Возможность использования при визуализации значений цвета Alpha представляет собой функциональную возможность, обеспечиваемую Microsoft Windows GDI+. Для получения более подробной информации смотрите Использование GDI+ в отчетах.

Пример

The following example cycles through different color combinations based for the odd and even instances of any report's Detail band Expressions, providing a "greenbar" output effect. It also applies some style attributes to elements not in Detail bands. Notice that these effects are applied only to Expressions (for example, labels in a Page Header band are not affected).

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

oReportListener = CREATEOBJECT("greenBar") oReportListener.ListenerType = 1 REPORT FORM (GETFILE("frx")) PREVIEW OBJECT oReportListener #DEFINE DETAIL_BAND 4 #DEFINE BOLD_UNDERLINE_ITALIC 1+4+2 DEFINE CLASS greenBar AS ReportListener detailInstance = 0 isDetail = .F. PROC BeforeBand(nBandObjCode, nFRXRecno) IF nBandObjCode = DETAIL_BAND THIS.detailInstance = THIS.detailInstance + 1 THIS.isDetail = .T. ELSE THIS.isDetail = .F. ENDIF ENDPROC PROC EvaluateContents(nFRXRecno, oProps) oProps.Reload = .T. * в этом примере перезагружается каждый раз, * так как мы хотим изменить каждый элемент Expression IF THIS.isDetail IF THIS.detailInstance % 2 = 0 oProps.penRed = 0 oProps.penBlue = 125 oProps.penGreen = 0 ELSE oProps.penRed = 0 oProps.penBlue = 0 oProps.penGreen = 0 oProps.fillRed = 0 oProps.FillBlue = 0 oProps.FillGreen = 255 oProps.FillAlpha = 125 *half-transparent background color ENDIF ELSE oProps.FontStyle = BOLD_UNDERLINE_ITALIC ENDIF ENDPROC ENDDEFINE

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