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.