Chart platform

A chart platform is a container for other chart elements. You can use the properties listed in the following table to control the appearances or behavior of a chart platform. In the Inspector panel, a chart platform is displayed as ChartObject by default.

The properties of a chart platform are:

Property Name Description
General
Display Name Specifies the display name of the object.

Data type: String
Instance Name Shows the instance name of the object. This property is read only.
Geometry
Height Specifies the height of the object, in inches. Enter a numeric value to change the height.

Data type: Float
Width Specifies the width of the object, in inches. Enter a numeric value to change the width.

Data type: Float
X Specifies the horizontal coordinate of the top left corner of the object, relative to its parent container. This property is unavailable if the Position property is set to static. Enter a numeric value to change the position in inches.

Data type: Float
Y Specifies the vertical coordinate of the top left corner of the object, relative to its parent container. This property is unavailable if the Position property is set to static. Enter a numeric value to change the position in inches.

Data type: Float
Others
Export to Applet Specifies whether to include the object when exporting the report to Applet.

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 exporting the report to Report Result.

Data type: Boolean

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

Data type: Boolean

Invisible Specifies whether to show or hide the object. All formulas and calculations will still be performed if the property is set to true. You can also use a formula to control whether or not to show the object.

Data type: Boolean
Position Specifies the position of the object. Available when the object is directly contained in the report body or a tabular cell.
  • absolute - The object's position will be decided by its X and Y property values.
  • static - The object will be positioned at the default location in its container. If selected, the X, Y and other position-related properties will be hidden or disabled.

Data type: Enumeration
Platform
Minimum Tick Mark Space Specifies the minimum space between two adjacent tick marks. Enter a numeric value to change the space.

Data type: Float
Show Legend Specifies whether to make the legend visible in a chart.

Data type: Boolean

Background
Border Color Specifies the color of the platform border. Choose a color from the drop-down list, enter a hexadecimal RGB value (for example, 0xCCAA00), or select Custom from the drop-down list to access the Color Picker dialog and specify a new color.

Data type: String
Border End Caps Specifies the ending style of the platform border line. Choose an option from the drop-down list.

Data type: Enumeration
Border Joint Specifies the joint style of the platform border line. Choose an option from the drop-down list.

Data type: Enumeration
Border Style Specifies the line style of the platform border. Choose an option from the drop-down list.

Data type: Enumeration
Border Thickness Specifies the width of the platform border, in inches. Enter a numeric value to change the thickness.

Data type: Float

Border Transparency Specifies the transparency of the platform border, in percent. Enter a numeric value to change the transparency.

Data type: Integer
Border Type Specifies the border type of the platform. Choose an option from the drop-down list.

Data type: Enumeration
Border Variable Dash Specifies whether to resize the dash automatically.
  • true - If selected, the dash size will be adjusted automatically.
  • false - If selected, the dash size will be of fixed size.

Data type: Boolean

Color Specifies the color of the platform background, applied when the property Fill Type is set to color. Choose a color from the drop-down list, enter a hexadecimal RGB value (for example, 0xff0000), or select Custom from the drop-down list to access the Color Picker dialog to specify the color and fill effect.

Data type: String

Fill Transparency Specifies the transparency of the platform background, in percent. Enter a numeric value to change the transparency.

Data type: Integer
Fill Type Specifies the fill pattern for the platform background. Choose an option from the drop-down list.

Data type: Enumeration
Inset Bottom Specifies the bottom position of the background area, measured in a percentage of the chart height, from the bottom edge of the chart.

Data type: Float

Inset Left Specifies the left position of the background area, measured in a percentage of the chart width, from the left edge of the chart.

Data type: Float

Inset Right Specifies the right position of the background area, measured in a percentage of the chart width, from the right edge of the chart.

Data type: Float

Inset Top Specifies the top position of the background area, measured in a percentage of the chart height, from the top edge of the chart.

Data type: Float

Radius Specifies the radius for the joint of the platform border line. The property takes effect only when Border Joint is set to joint round. Enter a numeric value to change the radius.

Data type: Float
Data
Category End Offset The four properties work together to control the range of the data being displayed on a chart: Category Start Offset, Category End Offset, Series Start Offset, and Series End Offset.

Category End Offset specifies the ending offset of the categories. It does not apply to the charts which involve only one group.

Data type: Integer

Category Format Specifies the data format for the category axis (the X axis) to display the tick mark labels in the way you choose. Click in the value cell to specify the format in the Data Format dialog.

Data type: String

Category Start Offset The four properties work together to control the range of the data being displayed on a chart: Category Start Offset, Category End Offset, Series Start Offset, and Series End Offset.

Category Start Offset specifies the starting offset of the categories. It does not apply to the charts which involve only one group.

Data type: Integer
Hint Percent Format Specifies the format for each hint percentage to the total. Click in the value cell to specify the format in the Data Format dialog.

Data type: String
Hint Value Format Specifies the number format for the hint message. Click in the value cell to specify the format in the Data Format dialog.

Data type: String

Hyperlink Specifies whether to add a hyperlink that refers to another report or a website to the data markers of the chart.

Data type: String
Hyperlink Target Specifies the target window or frame in which to display the content the Hyperlink property specifies. Choose an option from the drop-down list.
  • <Server Setting>
    Loads the linked file according to setting of the Pop Up New Window for Links option in the Customize Profile panel of the Profile dialog in JReport Server.
  • New Window
    Loads the linked file into a new window. The window is not named.
  • Whole Window
    Loads the linked file into the full browser window.
  • Same Frame
    Loads the linked file into the same frame as the link.
  • Parent Frame
    Loads the linked file into the parent frame of the frame that contains the link.
  • Other Frame
    Loads the linked file into some other specified frame. If selected, you can also directly input the name of the frame you have defined in the text box. If the frame name does not exist, the linked file will be loaded into a new window.

Data type: String
Motion Bar Format Specifies the data format for the motion field values displayed on the motion bar. Click in the value cell to specify the format in the Data Format dialog.

Data type: String

Overall Series Specifies whether to calculate the top or bottom N category values based on the series values.

Data type: Boolean

Primary Data Format Specifies the data format for the primary value axis (the Y1 axis) to display the tick mark labels in the way you choose. Click in the value cell to specify the format in the Data Format dialog.

Data type: String

Reverse Category Specifies whether to reverse the sequence of the category field value.

Data type: Boolean

Reverse Series Specifies whether to reverse the sequence of the series field value.

Data type: Boolean

Secondary Data Format Specifies the data format for the secondary value axis (the Y2 axis) to display the tick mark labels in the way you choose. Click in the value cell to specify the format in the Data Format dialog.

Data type: String

Series End Offset The four properties work together to control the range of the data being displayed on a chart: Category Start Offset, Category End Offset, Series Start Offset, and Series End Offset.

Series End Offset specifies the ending offset of the series.

Data type: Integer
Series Format Specifies the data format for the series axis (the Z axis) to display the tick mark labels in the way you choose. Click in the value cell to specify the format in the Data Format dialog.

Data type: String

Series Start Offset The four properties work together to control the range of the data being displayed on a chart: Category Start Offset, Category End Offset, Series Start Offset, and Series End Offset.

Series Start Offset specifies the starting offset of the series.

Data type: Integer
Sort Category Specifies the sorting order for the category field values. Choose an option from the drop-down list.

Data type: Enumeration

Sort Series Specifies the sorting order for the series field values. Choose an option from the drop-down list.

Data type: Enumeration

Swap Groups Specifies to display values from different data fields by switching data between the category and series axes, the category and value axes of a chart. By default, this property is set to false, which means no switch will take place in the chart.
  • Switching between the category and series axes
    If you create a chart by adding fields to all of its axes, and set Swap Groups to true, data on the category and series axes will be switched.
  • Switching between the category and value axes
    If you create a chart by adding one field to the category axis and several to the value axis, and set Swap Groups to true, data on the category and value axes will be switched.

Data type: Boolean

Note: If the chart has only one field on the category axis and one on the value axis, even though the property value is set to true, there will be no switch take place on the two axes.
X HyperLink Specifies whether to add a hyperlink that refers to another report or a website to the X axis labels.

Data type: String

X Hyperlink Target Specifies the target window or frame in which to display the content the X Hyperlink property specifies. Choose an option from the drop-down list.
  • <Server Setting>
    Loads the linked file according to setting of the Pop Up New Window for Links option in the Customize Profile panel of the Profile dialog in JReport Server.
  • New Window
    Loads the linked file into a new window. The window is not named.
  • Whole Window
    Loads the linked file into the full browser window.
  • Same Frame
    Loads the linked file into the same frame as the link.
  • Parent Frame
    Loads the linked file into the parent frame of the frame that contains the link.
  • Other Frame
    Loads the linked file into some other specified frame. If selected, you can also directly input the name of the frame you have defined in the text box. If the frame name does not exist, the linked file will be loaded into a new window.

Data type: String