|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface JRCrosstab
Crosstab element interface.
Field Summary | |
---|---|
static int |
DEFAULT_COLUMN_BREAK_OFFSET
The default offset used for column breaks. |
static byte |
RUN_DIRECTION_LTR
Crosstab left to right run direction. |
static byte |
RUN_DIRECTION_RTL
Crosstab right to left run direction. |
static java.lang.String |
VARIABLE_COLUMN_COUNT
Name of the built-in column count variable. |
static java.lang.String |
VARIABLE_ROW_COUNT
Name of the built-in row count variable. |
Fields inherited from interface net.sf.jasperreports.engine.JRElement |
---|
MODE_OPAQUE, MODE_TRANSPARENT, POSITION_TYPE_FIX_RELATIVE_TO_BOTTOM, POSITION_TYPE_FIX_RELATIVE_TO_TOP, POSITION_TYPE_FLOAT, STRETCH_TYPE_NO_STRETCH, STRETCH_TYPE_RELATIVE_TO_BAND_HEIGHT, STRETCH_TYPE_RELATIVE_TO_TALLEST_OBJECT |
Method Summary | |
---|---|
JRCrosstabCell[][] |
getCells()
Returns the data cell matrix. |
int |
getColumnBreakOffset()
Returns the column break offset. |
JRCrosstabColumnGroup[] |
getColumnGroups()
Returns the column groups of the crosstab. |
JRCrosstabDataset |
getDataset()
Returns the input dataset of the crosstab. |
JRElement |
getElementByKey(java.lang.String key)
Searches for an element inside all crosstab cells. |
JRCellContents |
getHeaderCell()
Returns a cell which will be rendered at the upper-left corner of the crosstab. |
int |
getId()
Returns the ID of the crosstab. |
JRCrosstabMeasure[] |
getMeasures()
Returns the crosstab measures. |
JRCrosstabParameter[] |
getParameters()
Returns the crosstab parameters. |
JRExpression |
getParametersMapExpression()
Returns the parameters map expression. |
JRCrosstabRowGroup[] |
getRowGroups()
Returns the row groups of the crosstab. |
byte |
getRunDirection()
Retrieves the run direction of this crosstab. |
JRVariable[] |
getVariables()
Returns the variables defined for the crosstab. |
JRCellContents |
getWhenNoDataCell()
Returns a cell which will be rendered when no data was fed to the crosstab. |
boolean |
isRepeatColumnHeaders()
Returns whether to repeat the column headers after a row break. |
boolean |
isRepeatRowHeaders()
Returns whether to repeat the row headers after a column break. |
void |
setRunDirection(byte direction)
Sets the run direction of the crosstab. |
Methods inherited from interface net.sf.jasperreports.engine.JRElement |
---|
collectExpressions, getElementGroup, getHeight, getKey, getPositionType, getPrintWhenExpression, getPrintWhenGroupChanges, getStretchType, getWidth, getX, getY, isPrintInFirstWholeBand, isPrintRepeatedValues, isPrintWhenDetailOverflows, isRemoveLineWhenBlank, setBackcolor, setForecolor, setMode, setMode, setPositionType, setPrintInFirstWholeBand, setPrintRepeatedValues, setPrintWhenDetailOverflows, setRemoveLineWhenBlank, setStretchType, setWidth, setX |
Methods inherited from interface net.sf.jasperreports.engine.JRChild |
---|
clone |
Methods inherited from interface net.sf.jasperreports.engine.JRVisitable |
---|
visit |
Methods inherited from interface net.sf.jasperreports.engine.JRCloneable |
---|
clone |
Methods inherited from interface net.sf.jasperreports.engine.JRCommonElement |
---|
getBackcolor, getForecolor, getMode, getOwnBackcolor, getOwnForecolor, getOwnMode |
Methods inherited from interface net.sf.jasperreports.engine.JRStyleContainer |
---|
getDefaultStyleProvider, getStyle, getStyleNameReference |
Methods inherited from interface net.sf.jasperreports.engine.JRPropertiesHolder |
---|
getParentProperties, getPropertiesMap, hasProperties |
Field Detail |
---|
static final int DEFAULT_COLUMN_BREAK_OFFSET
getColumnBreakOffset()
,
Constant Field Valuesstatic final java.lang.String VARIABLE_ROW_COUNT
static final java.lang.String VARIABLE_COLUMN_COUNT
static final byte RUN_DIRECTION_LTR
static final byte RUN_DIRECTION_RTL
When a crosstab is filled from right to left, the crosstab contents will start from the right extremity of the crosstab element area and grow towards the left.
Method Detail |
---|
int getId()
The ID is generated when the report is compiled and is used internally.
JRCrosstabDataset getDataset()
JRCrosstabRowGroup[] getRowGroups()
JRCrosstabColumnGroup[] getColumnGroups()
JRCrosstabMeasure[] getMeasures()
int getColumnBreakOffset()
When the crosstab columns do not fit the width, the crosstab breaks the columns and prints the ones that don't fit after printing the first set of columns for all rows. This method returns the offset to be used when continuing the printing after a column break.
boolean isRepeatColumnHeaders()
boolean isRepeatRowHeaders()
JRCrosstabCell[][] getCells()
A crosstab can have multiple data cells for row/groups totals. These cells are organized in a (rowGroupCount + 1) x (columnGroupCount + 1) matrix as following:
E.g. if the crosstab has Country and City (subgroup of Country) row groups and Year and Month column groups, the cells will be organized in the following matrix
0/Years total | 1/Months total | 2/Base | |
0/Countries total | Total for all countries and all years | Total for all countries and a year | Total for all countries and a month |
1/Cities total | Total for a country and all years | Total for a country and a year | Total for a country and a month |
2/Base | Total for a city and all years | Total for a city and a year | Total for a city and a month |
If the data cell for a total row/column is not specified, the cell will be inherited from lower levels, if possible. For example, if the "Total for all countries and a year" cell is not specified, the "Total for a country and a year" or "Total for a city and a year" cell will be used (in this order).
The data cell sizes are calculated from the base data cell sizes, i.e. the height of all data cells for a row will be the height of the base cell of that row. The base cell sizes are also inherited, e.g. if the height of a total row is not specified the height of the base row will be used.
JRCrosstabParameter[] getParameters()
Crosstabs have separate expression evaluators and cannot access the parameters/fields/variables of the report. In order to use a value from the report inside a crosstab, it should be passed as parameter to the crosstab.
A crosstab parameters has a name and a value expression.
JRExpression getParametersMapExpression()
The set of values for crosstab parameters can be set using a map. If a parameter has also a value expression, it will overwrite the value from the map.
JRCellContents getWhenNoDataCell()
If this cell is not specified for a crosstab, nothing will be rendered for an empty crosstab.
The cell sizes are the same as the crosstab element sizes.
JRElement getElementByKey(java.lang.String key)
key
- the element key
JRCellContents getHeaderCell()
JRVariable[] getVariables()
JRCrosstabGroup.getVariable()
,
JRCrosstabMeasure.getVariable()
,
VARIABLE_ROW_COUNT
,
VARIABLE_COLUMN_COUNT
byte getRunDirection()
setRunDirection(byte)
void setRunDirection(byte direction)
Crosstabs can either be filled from left to right (the default) or from right to left (mainly for reports in RTL languages).
direction
- one of RUN_DIRECTION_LTR
and RUN_DIRECTION_RTL
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |