Component Reference

Section properties

Sumary

The sections are contained inside subreports, depending on the section type it will print after the detail (group header), before the detail (group header), or in special places (page headers and footers)

Name Internal Name Type Description
Horz.Desp HorzDesp Boolean When horizzontal desplacement is set to true, after printing the section the print position will move to the left, in an amount equivalent to the section width. But this will happen only when the next section to print has also the horizontal desplacement set to true, else the horizontal print position will be restored. Set this property to true in the detail section for example to print labels left to right, adjust the section with so many details fit in the total page width. See also labels documentation.
Vert.Desp. VertDesp Boolean When vertical desplacement is set to true, the print is performed as usually (up to down), after reaching the bottom of the page, the print position will place at the top of the page (or group header) , and the left print position will move an amount equivalent to the section with (if fits in the page), then printing continue. But this will happen only when the next section to print has also the vertical desplacement set to true, else the engine will skip to next page. Set this property to true in the detail section for example to print labels up to down, adjust the section with so many details fit in the total page width. See also labels documentation.
Auto expand AutoExpand Boolean The section will expand vertically to keep space for any component inside it. This is useful when you want to print some variable text and you don't know how much page space you need
Auto contract AutoContract Boolean The section will contract vertically to avoid unused space. This is useful when you want to print some variable text and you don't know how much page space you need, of if some of the components are printed under certain conditions and you want to profit space
Init.PageNum InitPageNum Boolean Available only for groups, initialize the variable PageNum to 1 when the group changes
Group Name GroupName String Group name, to be referenced in TRpExpressions to aggregate values
Group Expression ChangeExpression WideString This expression is evaluated for each record of the Main dataset for the subreport, it will determine a group break with the Bool Expression property
Bool Expression ChangeBool Boolean If true, the engine breaks the group when the Group Expression is true, else will break the group when the group expression result changes
Page repeat PageRepeat Boolean If true, the group header will print in each page where the group is still active.
Begin Page BeginPageExpression WideString This expression is evaluated before printing, if result is true the group will begin a page
Skip Page SkipPage Boolean If this property is true, after printing the section a new page will begin (unless there is nothing more to print)
Align Bottom AlignBottom Boolean If this property is true, the section will be aligned to the bottom of the page, and of course next section will be printed in the next page, the alignment is done after resizing (so it's compatible with Auto expand and Auto contract properties)
Horz.Desp. HorzDesp Boolean If this property is true, the displazement for the next printed section will be horizontal, not vertical unless the next section have this property false.
Skip Type SkipType TRpSkipType

Default=no skip, Before=skip before print, After=skip after print

The skip is a repositioning of the print pointer, you can place print pointer to another page and/or page position with properties bellow

Skip to page SkipToPageExpre WideString If a skip type is assigned then this expression is used to determine the page to relocate the print pointer
H.Skip Expre SkipExpreH WideString

Determines the horizontal position, the result of the expression must be an integer, the unit is in twips (1440twips=1 inch), the skip may be relative or absolute depending on property bellow

H.Relative Skip SkipRelativeH Boolean If true the skip is relative to the print pointer else is relative to the current page
V.Skip Expre SkipExpreV WideString Determines the verticalposition, the result of the expression must be an integer, the unit is in twips (1440twips=1 inch), the skip may be relative or absolute depending on property bellow
V.Relative Skip SkipRelativeV Boolean If true the skip is relative to the print pointer else is relative to the current page
Child subreport ChildSubreport TRpSubReport If a child subreport is assigned it will be processed and printed after printing this section, see also child subreports reference.
External Path FExternalFilenam String Will load the section from a file so the report file can share sections. The external path can be an expression by preceding the string by the @ symbol.
External Database ExternalDat.Tabl.F String Will load the section from a database so the reports can share sections.
Global Scope Global Boolean For page header and footers only, if this property is true, the header/footer will be processed globally just like if it was outside the subreport
Force Print ForcePrint Boolean Only for page footers, means the page footer must print at the end of the subreport if no data is still available
Image Stream TStream Embedded image, stored with the report structure containing a image stream, will be drawn bellow the grid, using the resolution bellow. When embedding large images you should set prefered save format in page setup to binary/gzip to enhace performance.
Resolution (dpi) dpires Integer Resolution of the image in pixels per inch unit, the size of the bitmap and the resolution will determine the final size
Background Style BackStyle TBackStyle The background of the section can be used for multiple purposes, one is help in design time to fill a form for example, but no preview or print (preprinted forms). You can also select to draw the background image in preview or print the image on the paper also.
Back. Expression Expression WideString The image can be embedded (Image propery) or obtained throught this expression property, the expression is evaluated, if the expression result is a binary database field will try to read the image from there, see below the image formats supported. If the field is a string field or the result of evaluation is a string the engine will try to load the image as a file reference.
Export Expression ExportExpression WideString A expression to obtain the value that will be uses in custom output text format
Exp. Format ExportDisplayFormat String The display format will be used if provided to format the export expression
Exp. Line ExportLine Integer The exact line of the text file where the export result will be placed, if you set this value to 0, the current (last) line will be used
Exp. Position ExportPosition Integer Postion inside the line (first position is 1), where the text will be placed in custom text output
Exp. Size ExportSize Integer Size of the output for custom text output, will be right padded with blank characters
Exp.New Line ExportDoNewLine Boolean If this value is true, a new line will be added after exporting this item in custom text output

Developer info

Internal component name TRpSection
Parent class TRpCommonComponent
Unit name rpsection.pas

See also Report components common properties.