List component interface.
Container of report elements that are to be printed for each record in the list subdataset.
Base fill list component implementation.
Used to iterate on the list subdataset at fill time.
List contents fill element container.
Horizontal fill list component implementation.
Compile-time handler of
List preview converter.
Am image renderer used to mark the unused vertical space in a list component preview.
Vertical fill list component implementation.
A list component is a report element that iterates on a set of records and renders a cell for each record.
The data for a list is obtained via a subdataset defined in the report. The list component
<datasetRun> JRXML element (equivalent to a
JRDatasetRun at the API level), which contains
information required to instantiate a report subdataset. A data source object can be sent
to the subdataset, or, when the subdataset embeds a query, connection parameters and
query parameters can be provided. The subdataset is instantiated when the list
component is evaluated and it iterates through the records it produces.
The list cell consists of a report element which will be rendered for each record in the
dataset. This element can be a frame which nests several elements. The list cell is
evaluated in the context of the subdataset, therefore expressions used by the elements can
only refer to parameters, fields and variables which are defined in the subdataset. Also,
delayed evaluation times will not work for elements in the list cells because the elements
are not evaluated in the context of the main report dataset.
The cell width is the same as the defined width of the component element; the height is given by an attribute of the list. The contents of the cell must fit within the width and height of the cell.
When iterating on the dataset records, the list component renders cells vertically in a
single column if
Vertical, or it renders cells side by side, in a single
row, if the
printOrder attribute is set to
Horizontal. For horizontally filled lists, the
row breaking behavior is controlled by the
ignoreWidth attribute, which either forces a
row break when list width limit is reached, or lets the cells stretch beyond the list
declared width limit. The list cell height is used as the column's minimum height. If the
space remaining at the bottom of the page is less than the cell height, a column/page
overflow is triggered and the list continues rendering on a new column/page.
The height of the list component element itself can be greater than the list cell height. The list element height is used as minimum height of the entire list, that is, the list will not start rendering unless the space remaining on the page is at least the height of the element.
© 2001 - 2017 TIBCO Software Inc. www.jaspersoft.com