8.8. Part column #

8.8.1. Part column attributes

A part column (<pd>) may contain one or more Reports (<Report>) which are layed out vertically in this column continuously.

Such a report may be inlined:

<Part>
    <pr>
        <pd>
            <Report>
                ...
            </Report>
        </pd>
    </pr>
</Part>

A report may also be loaded from a separate file. For details, see Loaded report.

<Part>
    <pr>
        <pd>
            <load ... />
        </pd>
    </pr>
</Part>

8.8.1. Part column attributes #

Note that any attribute setting below may only use constant expressions or an query column reference from Independent queries. An environment variable (since it can't - or shouldn't - change during the report execution) is considered constant. See Expressions. This allows external control for the attributes in question.

8.8.1.1. Width #

Width of the part column. Optional.

<pd width="60">

When Size unit attribute is set to rlib (the default), the column width is measured in characters, which is controlled by Part font size. Note, that the font width and height may differ, depending on the font face controlled by Part font name. Width is computed from the font width.

When Size unit attribute is set to points, width is measured in points.

Columns without explicitly specified width are dynamically sized according to Paper type, Margin settings and other columns in the same Part row that do have explicitly set width.

Columns that exceed the total page width (according to Paper type and Margin settings) will be shown partially, or won't be shown at all.

8.8.1.2. Height #

Height of the part column.

<pd height="120">

When Size unit attribute is set to rlib (the default), the column height is measured in characters, which is controlled by Part font size. Note, that the font width and height may differ, depending on the font face controlled by Part font name. Column height is computed from the font height.

When Size unit attribute is set to points, height is measured in points.

Report details in this part column are layed out up to the specified height. See Report height for further explanation.

Note, that OpenCReports allows fixed height columns to break over page boundaries. This is a deviation from RLIB.

8.8.1.3. Border width #

Border width around the part column. It is measured in points.

<pd border_width="2">

When set, a rectangle around the part column will be drawn. The width of outline of the rectangle is measured in points.

This is a deviation from RLIB where the width of the outline was a fixed 0.1 points and an inner margin (all of top, bottom, left and right) inside the column border was used.

If the column breaks over a page boundary, the border will be drawn the column parts on every page.

8.8.1.4. Border color #

When border_width is set, this color is used to draw the border rectangle.

<pd border_color="'blue'">

See Color specification.

8.8.1.5. Detail columns #

Inner <Report>s are layed out in one or more columns.

<pd detail_columns="3">

Default value is 1.

8.8.1.6. Column padding #

When detail_columns is set to higher than 1, inner padding between the detail columns may be specified.

<pd column_pad="0.2">

Default value is 0, i.e. no padding.

The unit of padding is inches if Size unit attribute is set to rlib (default), points otherwise.

8.8.1.7. Suppress #

Report columns may be suppressed.

<pd suppress="yes">

Default value is false, i.e. no suppression.