See: Description
Interface | Description |
---|---|
ListComponent |
List component interface.
|
ListContents |
Container of report elements that are to be printed for each record in the
list subdataset.
|
Class | Description |
---|---|
BaseFillList |
Base fill list component implementation.
|
BaseFillList.AppendingPrintElementContainer | |
BaseListContents |
ListContents implementation used in compiled reports. |
DesignListContents |
ListContents implementation used at report design time. |
FillDatasetRun |
Used to iterate on the list subdataset at fill time.
|
FillListContents |
List contents fill element container.
|
FillListFactory |
Factory of
list fill component instances. |
HorizontalFillList |
Horizontal fill list component implementation.
|
ListComponentCompiler |
Compile-time handler of
list component instances. |
ListDesignConverter |
List preview converter.
|
StandardListComponent |
Standard
ListComponent implementation. |
UnusedSpaceImageRenderer |
Am image renderer used to mark the unused vertical space in a list
component preview.
|
VerticalFillList |
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
includes a <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 printOrder
is 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.
Copyright © 2017. All rights reserved.