Crosstab

The properties of a crosstab object in a web report are as follows. The DBField, Formula Field and Label in a crosstab have different properties compared with in other containers.

Property Name	Description
Geometry
Height	Displays the height of the object. This property is read only.
Width	Displays the width of the object. This property is read only.
X	Specifies the horizontal coordinate of the top left corner of the object, relative to its parent container. This property is ignored if the Position property is set to static. Enter a numeric value to change the position. Data type: Float
Y	Specifies the vertical coordinate of the top left corner of the object, relative to its parent container. This property is ignored if the Position property is set to static. Enter a numeric value to change the position. Data type: Float
Color
Background	Specifies the background color of the object. Choose a color from the drop-down list or select Custom to customize a color. You can also enter a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String
Alternating Line Color
Direction	Specifies whether the color defined by the property Pattern List will apply to the fields in the same rows or columns in the crosstab. vertical - The value of the property Pattern List will take effect on the fields in the same columns, except for the total columns. horizontal - The value of the property Pattern List will take effect on the fields in the same rows, except for the total rows. Data type: Enumeration
Enable	Specifies whether to enable setting alternating line color for the crosstab. Only when it is set to true, the settings for the properties Direction and Pattern List can take effect. Data type: Boolean Note: The setting of the alternating line color function for crosstab can only take effect when all the aggregate fields in the crosstab have transparent background.
Pattern List	Specifies the color pattern for the fields in the same rows or columns in the crosstab. Click in the value cell and click the small squares in the color tray one by one to specify the patterns. The patterns can be one or more of the following: Automatic, Color, Texture, and Gradient. Data type: String
CSS
Class	Specifies a CSS class to be applied to the object which is a valid class in the CSS file. Data type: String
Style	The property can be used in two ways. Specifies a style to be applied to the object. Choose a style from the drop-down list which is available when a Style Group has been selected at the report tab level and when there are styles in the Style Group that can be applied to the object, or type in the style name. Specifies a CSS selector to be applied to the object. Enter a valid class name from the CSS file. Data type: String
Others
Default for Filter	Specifies whether to show the data component as the default component in the Apply to drop-down list of the Filter dialog in Web Report Studio. Data type: Boolean Note: In a web report, only one data component’s Default for Filter property can be set to true.
Enable Navigation	Specifies whether to enable scrollbars on the crosstab when the parent container cannot fully display the data of the crosstab. When this property is set to true, you can further specify the height and width of the frame for holding the crosstab, by setting the two properties Navigation Height and Navigation Width. Data type: Boolean
Export to Applet	Specifies whether to include the object when exporting the report to Applet. Data type: Boolean
Export to CSV	Specifies whether to include the object when exporting the report to CSV. Data type: Boolean
Export to Excel	Specifies whether to include the object when exporting the report to Excel. Data type: Boolean
Export to HTML	Specifies whether to include the object when exporting the report to HTML. Data type: Boolean
Export to PDF	Specifies whether to include the object when exporting the report to PDF. Data type: Boolean
Export to PostScript	Specifies whether to include the object when exporting the report to PostScript. Data type: Boolean
Export to Report Result	Specifies whether to include the object when previewing the report in Web Report Result or running the report in Web Report Studio. Data type: Boolean
Export to RTF	Specifies whether to include the object when exporting the report to RTF. Data type: Boolean
Export to Text	Specifies whether to include the object when exporting the report to Text. Data type: Boolean
Export to XML	Specifies whether to include the object when exporting the report to XML. Data type: Boolean
Invisible	Specifies whether to show the object in the design area and in the report results. All formulas and calculations will still be performed if the property is set to true. Data type: Boolean
Invisible for Filter Dialogs	Specifies whether to show the data component in the Apply to drop-down list of the Filter dialog in Web Report Studio. This property cannot be edited when Default for Filter is set to true. Data type: Boolean
Navigation Height	Specifies the height of the frame for holding the crosstab. Enter a numeric value to specify the height. If no value is given here, JReport will calculate the height at runtime. This property takes effect only when Enable Navigation is set to true. Data type: Float
Navigation Width	Specifies the width of the frame for holding the crosstab. Enter a numeric value to specify the width. If no value is given here, JReport will calculate the width at runtime. This property takes effect only when Enable Navigation is set to true. Data type: Float
Position	Specifies the position of the object. Choose an option from the drop-down list. static - The object is positioned at the location in which it is inserted. If selected, the X, Y and other position-related properties will be hidden or disabled. The position of the object is affected by preceding objects in the same container. absolute - The object will be located at the position specified by dragging and dropping or by setting its X and Y property values. The position of the object is not affected by preceding objects in the same container. Data type: Enumeration
Record Location	Specifies the calculation point for the properties which use formulas. Choose an option from the drop-down list. Default - The values of the properties are calculated in the default location where they are located. Page Header - The values of the properties are calculated in the page header. Page Footer - The values of the properties are calculated in the page footer. Data type: Enumeration
Suppress	Specifies whether to show the object in the design area and in the report results. All formulas and calculations will be skipped if the property is set to true. Data type: Boolean Note: When both the Invisible and Suppress properties of an object are set to true, Suppress has the higher priority.
Suppress When No Records	Specifies whether to display the object in the report results when no record is returned to its parent data component. Data type: Boolean
Excel
Column Index	Specifies the X coordinate of the object relative to its parent container when exported to Excel or CSV, measured in cells. The Columned property at the report level must be set to true for this property to take effect. Data type: Integer
Row Index	Specifies the Y coordinate of the object relative to its parent container when exported to Excel or CSV, measured in cells. The Columned property at the report level must be set to true for this property to take effect. Data type: Integer
Border
Border Color	Specifies the color of the border of the object. Choose a color from the drop-down list or select Custom to customize a color. You can also enter a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String
Has Border	Specifies whether to show the cell borders. Data type: Boolean
Crosstab Property
Boundary Value	Specifies the number of columns in one aggregate cell when the crosstab is displayed horizontally, or rows when displayed vertically. Data type: Integer
Column Totals on Left	Specifies whether to display the total columns on the left of the aggregates. Data type: Boolean
Horizontal Gap	Specifies the space between the left/right edge of a crosstab cell and the contents in it. Data type: Float
Row Totals on Top	Specifies whether to display the total rows on the top of the aggregates. Data type: Boolean
Suppress Column Header	Specifies whether to suppress the column header in view mode. Data type: Boolean
Suppress Row Header	Specifies whether to suppress the row header in view mode. Data type: Boolean
Use Table Style	Specifies whether to add headers to the Total rows and columns. Data type: Boolean
Vertical Gap	Specifies the space between the top/bottom edge of a crosstab cell and the contents in it. Data type: Float
Vertical Layout	Indicates whether the aggregate fields are displayed vertically. The property is read only.
TOC
Anchor Display Value	Specifies a string or formula to display for the TOC entry for this object in the TOC Browser. By default it is the value of the specified object. The TOC Anchor property must be set to true for this property to take effect. Data type: String
TOC Anchor	Specifies whether to include the object in the TOC Browser for the report. Data type: Boolean

Property Name

Description

Geometry

Height

Displays the height of the object. This property is read only.

Width

Displays the width of the object. This property is read only.

Specifies the horizontal coordinate of the top left corner of the object, relative to its parent container. This property is ignored if the Position property is set to static. Enter a numeric value to change the position.

Data type: Float

Specifies the vertical coordinate of the top left corner of the object, relative to its parent container. This property is ignored if the Position property is set to static. Enter a numeric value to change the position.

Data type: Float

Color

Background

Specifies the background color of the object. Choose a color from the drop-down list or select Custom to customize a color. You can also enter a hexadecimal RGB value (for example, 0xff0000) to specify a color.

Data type: String

Alternating Line Color

Direction

Specifies whether the color defined by the property Pattern List will apply to the fields in the same rows or columns in the crosstab.

vertical - The value of the property Pattern List will take effect on the fields in the same columns, except for the total columns.
horizontal - The value of the property Pattern List will take effect on the fields in the same rows, except for the total rows.

Data type: Enumeration

Enable

Specifies whether to enable setting alternating line color for the crosstab. Only when it is set to true, the settings for the properties Direction and Pattern List can take effect.

Data type: Boolean

Note: The setting of the alternating line color function for crosstab can only take effect when all the aggregate fields in the crosstab have transparent background.

Pattern List

Specifies the color pattern for the fields in the same rows or columns in the crosstab. Click

in the value cell and click the small squares in the color tray one by one to specify the patterns. The patterns can be one or more of the following: Automatic, Color, Texture, and Gradient.

Data type: String

CSS

Class

Specifies a CSS class to be applied to the object which is a valid class in the CSS file.

Data type: String

Style

The property can be used in two ways.

Specifies a style to be applied to the object. Choose a style from the drop-down list which is available when a Style Group has been selected at the report tab level and when there are styles in the Style Group that can be applied to the object, or type in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from the CSS file.

Data type: String

Others

Default for Filter

Specifies whether to show the data component as the default component in the Apply to drop-down list of the Filter dialog in Web Report Studio.

Data type: Boolean

Note: In a web report, only one data component’s Default for Filter property can be set to true.

Enable Navigation

Specifies whether to enable scrollbars on the crosstab when the parent container cannot fully display the data of the crosstab.

When this property is set to true, you can further specify the height and width of the frame for holding the crosstab, by setting the two properties Navigation Height and Navigation Width.

Data type: Boolean

Export to Applet

Specifies whether to include the object when exporting the report to Applet.

Data type: Boolean

Export to CSV

Specifies whether to include the object when exporting the report to CSV.

Data type: Boolean

Export to Excel

Specifies whether to include the object when exporting the report to Excel.

Data type: Boolean

Export to HTML

Specifies whether to include the object when exporting the report to HTML.

Data type: Boolean

Export to PDF

Specifies whether to include the object when exporting the report to PDF.

Data type: Boolean

Export to PostScript

Specifies whether to include the object when exporting the report to PostScript.

Data type: Boolean

Export to Report Result

Specifies whether to include the object when previewing the report in Web Report Result or running the report in Web Report Studio.

Data type: Boolean

Export to RTF

Specifies whether to include the object when exporting the report to RTF.

Data type: Boolean

Export to Text

Specifies whether to include the object when exporting the report to Text.

Data type: Boolean

Export to XML

Specifies whether to include the object when exporting the report to XML.

Data type: Boolean

Invisible

Specifies whether to show the object in the design area and in the report results. All formulas and calculations will still be performed if the property is set to true.

Data type: Boolean

Invisible for Filter Dialogs

Specifies whether to show the data component in the Apply to drop-down list of the Filter dialog in Web Report Studio. This property cannot be edited when Default for Filter is set to true.

Data type: Boolean

Navigation Height

Specifies the height of the frame for holding the crosstab. Enter a numeric value to specify the height. If no value is given here, JReport will calculate the height at runtime. This property takes effect only when Enable Navigation is set to true.

Data type: Float

Navigation Width

Specifies the width of the frame for holding the crosstab. Enter a numeric value to specify the width. If no value is given here, JReport will calculate the width at runtime. This property takes effect only when Enable Navigation is set to true.

Data type: Float

Position

Specifies the position of the object. Choose an option from the drop-down list.

static - The object is positioned at the location in which it is inserted. If selected, the X, Y and other position-related properties will be hidden or disabled. The position of the object is affected by preceding objects in the same container.
absolute - The object will be located at the position specified by dragging and dropping or by setting its X and Y property values. The position of the object is not affected by preceding objects in the same container.

Data type: Enumeration

Record Location

Specifies the calculation point for the properties which use formulas. Choose an option from the drop-down list.

Default - The values of the properties are calculated in the default location where they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.

Data type: Enumeration

Suppress

Specifies whether to show the object in the design area and in the report results. All formulas and calculations will be skipped if the property is set to true.

Data type: Boolean

Note: When both the Invisible and Suppress properties of an object are set to true, Suppress has the higher priority.

Suppress When No Records

Specifies whether to display the object in the report results when no record is returned to its parent data component.

Data type: Boolean

Excel

Column Index

Specifies the X coordinate of the object relative to its parent container when exported to Excel or CSV, measured in cells. The Columned property at the report level must be set to true for this property to take effect.

Data type: Integer

Row Index

Specifies the Y coordinate of the object relative to its parent container when exported to Excel or CSV, measured in cells. The Columned property at the report level must be set to true for this property to take effect.

Data type: Integer

Border

Border Color

Specifies the color of the border of the object. Choose a color from the drop-down list or select Custom to customize a color. You can also enter a hexadecimal RGB value (for example, 0xff0000) to specify a color.

Data type: String

Has Border

Specifies whether to show the cell borders.

Data type: Boolean

Crosstab Property

Boundary Value

Specifies the number of columns in one aggregate cell when the crosstab is displayed horizontally, or rows when displayed vertically.

Data type: Integer

Column Totals on Left

Specifies whether to display the total columns on the left of the aggregates.

Data type: Boolean

Horizontal Gap

Specifies the space between the left/right edge of a crosstab cell and the contents in it.

Data type: Float

Row Totals on Top

Specifies whether to display the total rows on the top of the aggregates.

Data type: Boolean

Suppress Column Header

Specifies whether to suppress the column header in view mode.

Data type: Boolean

Suppress Row Header

Specifies whether to suppress the row header in view mode.

Data type: Boolean

Use Table Style

Specifies whether to add headers to the Total rows and columns.

Data type: Boolean

Vertical Gap

Specifies the space between the top/bottom edge of a crosstab cell and the contents in it.

Data type: Float

Vertical Layout

Indicates whether the aggregate fields are displayed vertically. The property is read only.

TOC

Anchor Display Value

Specifies a string or formula to display for the TOC entry for this object in the TOC Browser. By default it is the value of the specified object. The TOC Anchor property must be set to true for this property to take effect.

Data type: String

TOC Anchor

Specifies whether to include the object in the TOC Browser for the report.

Data type: Boolean