The Record Area element is used for adding data from the database field dynamically at runtime anywhere to the page in between text. Add it to any report sections (i.e. Header, Detail or Footer). Simply specify the name of the field between #...# between regular text and it will populate the value.
"Dear #FirstName# #LastName#, "
To add a Record Area, select the Record Area element under the Toolbox, drag and drop it at the desired location on the page. The Record Area can be resized or repositioned using the mouse, manually changing the values in the properties window or by changing the values directly in the source.
The Record Area element has the following properties.
|Align||A value indicating the alignment (horizontal) of the Record Area.|
|AutoLeading||A value indicating whether the leading of the Record Area should be calculated automatically.|
|CleanParagraphBreaks||A value indicating clean paragraph breaks for the paragraphs of the Record Area. *See Note Below|
|Font||A value indicating the font to be used for the Record Area.|
|FontSize||A value indicating the font size of the Record Area.|
|Leading||A value indicating the leading of the text.|
|ParagraphIndent||A value indicating the paragraph indenting for the paragraphs of the Record Area.|
|ParagraphSpacing||A value indicating the paragraph spacing for the paragraphs of the Record Area.|
|Text||A value indicating the text of the Record Area.|
|TextColor||A value indicating the text color of the Record Area.|
|Underline||A value indicating whether to underline the text of the Record Area.|
|VAlign||A value indicating the vertical alignment of the Record Area.|
|Id||A value indicating the programmatic identifier of the Record Area.|
|Angle||A value indicating the number of degrees to rotate the Record Area.|
|Expandable||A value indicating whether the Record Area is expandable or not.|
|Height||A value indicating the height of the Record Area.|
|Splittable||A value indicating whether the Record Area can be split between pages.|
|Width||A value indicating the width of the Record Area.|
|X||A value indicating the X coordinate of the Record Area.|
|Y||A value indicating the Y coordinate of the Record Area.|
Note on CleanParagraphBreaks
The CleanParagraphBreaks property being set to True will only have any affect on the Record Area if the Splittable property is also set to True. In other words the paragraph will not break at all (and therefore never needs to consider the type of break) if the Splittable property is set to false. If however CleanParagraphBreaks is set to True and Splittable is also set to True then LayoutEngine will take care to make sure that any splitting performed on the Record Area will always result in at least two lines of the paragraph being kept together (no orphaned lines). The only exception to this is if the paragraph itself is only one line then that one-lined paragraph will appear by itself.