Format Category (X) Axis dialog for library component

This dialog appears when you double-click the category (X) axis of a chart in a library component, or right-click it and then select Format Axes > Format Category (X) Axis from the shortcut menu. It helps you to format the category (X) axis of a chart, and consists of the following tabs:

• Axis tab
• Tick Mark tab
• Font tab
• Orientation tab
• Format tab
• Behaviors tab

OK

Applies the changes and closes the dialog.

Cancel

Does not retain any changes and closes the dialog.

Apply

Applies all changes and leaves the dialog open.

Help

Displays the help document about this feature.

Axis tab

Specifies the general properties for the axis. See the tab.

Option

Specifies the options for the axis.

• Minimum Value
  Specifies the minimum value that is to be displayed on the axis. Available only to bubble charts which use the axis to show numeric data and scatter charts.
• Maximum Value
  Specifies the maximum value that is to be displayed on the axis. Available only to bubble charts which use the axis to show numeric data and scatter charts.
• Increment
  Specifies the difference between two adjacent values on the axis. Available only to bubble charts which use the axis to show numeric data and scatter charts.
• Number of Tick Marks
  Specifies how many tick marks to be displayed on the axis. Available only to bubble charts which use the axis to show numeric data and scatter charts.
• Show Gridlines
  Specifies whether to show gridlines on the axis.

Scrollable Chart

Specifies whether to make the chart scrollable. If checked, a scrollbar will be added in the chart, with which you can control the visible value range on the axis. Available to 2-D charts of bar, bench, line, and area types only.

• Scrollable Visible Values
  Specifies how many data items will be selected on the scrollbar and displayed on the axis by default.
• Scrolling Area Percentage
  Specifies the percentage the scrollbar occupies the whole size of the chart.
• Show Chart in Scrolling Area
  Specifies whether to show the thumbnail chart on the scrollbar.

Line

Specifies the line style for the axis.

• Color
  Specifies the color of the axis.

  To change the color, click the color image button to display the color palette in which you can select a color, or click More Colors to customize the color within a wider range in the Pick a Color dialog. You can also input the hexadecimal value of a color directly in the text box after #.

• Style
  Specifies the style for the line of the axis.
• Transparency
  Specifies the transparency for the color of the axis.
• Thickness
  Specifies the thickness for the line of the axis, in pixels.

Gap

Specifies the gap properties for the labels on the axis.

• Label Axis Gap
  Specifies the distance between the label and the axis, in pixels.
• Best Effect
  Specifies whether to adjust the labels automatically to make them placed best.

Tick Mark tab

The tab consists of three sub tabs: major tick mark tab, minor tick mark tab, and scale tab.

Major Tick Mark tab

Specifies properties of the major tick marks on the axis. See the tab.

Type

Specifies the type of the major tick marks on the axis.

• None
  If selected, major tick marks will not be shown on the axis and it will be meaningless to specify all the other major tick mark related properties.
• Inside
  If selected, major tick marks will be inside the chart.
• Outside
  If selected, major tick marks will be outside the chart.
• Cross
  If selected, major tick marks will be across the axis.

Line

Specifies the line properties of the major tick marks on the axis.

• Correlate with Axis
  If checked, the line properties of the major tick marks will correlate with that of the axis automatically.
  • Color
    Specifies the color of the major tick marks.

    To change the color, click the color image button to display the color palette in which you can select a color, or click More Colors to customize the color within a wider range in the Pick a Color dialog. You can also input the hexadecimal value of a color directly in the text box after #.

  • Style
    Specifies the type of the major tick marks.
  • Transparency
    Specifies the transparency for the color of the major tick marks.
  • Thickness
    Specifies the thickness of the major tick marks, in pixels.
• Tick Mark Length
  Specifies the length of the major tick marks, in pixels.

Option

Specifies the other properties of the major tick mark labels on the axis.

• Show Major Tick Mark Labels
  Specifies whether to display the labels of the major tick marks on the axis. If checked, the following properties will be enabled.
• Label Every N Major Tick Marks
  Specifies the frequency at which the major tick marks will be labeled.
• Show Axis Label Tips
  Specifies whether to display the complete label text when the mouse pointer points at a label on the axis.
• Number of Major Labels
  Specifies how many major tick mark labels to be displayed on the axis.
  • Auto
    If checked, all major tick mark labels will be shown.
  • Fixed
    If checked, you can specify the number of the major tick mark labels to be displayed on the axis.

Minor Tick Mark tab

Specifies properties of the minor tick marks on the axis. See the tab.

Type

Specifies the type of the minor tick marks on the axis.

• None
  If selected, minor tick marks will not be shown on the axis and it will be meaningless to specify all the other minor tick mark related properties.
• Inside
  If selected, minor tick marks will be inside the chart.
• Outside
  If selected, minor tick marks will be outside the chart.
• Cross
  If selected, minor tick marks will be across the axis.

Line

Specifies the line properties of the minor tick marks on the axis.

• Correlate with Axis
  If checked, the line properties of the minor tick marks will correlate with that of the axis automatically.
  • Color
    Specifies the color of the minor tick marks.

    To change the color, click the color image button to display the color palette in which you can select a color, or click More Colors to customize the color within a wider range in the Pick a Color dialog. You can also input the hexadecimal value of a color directly in the text box after #.

  • Style
    Specifies the type of the minor tick marks.
  • Transparency
    Specifies the transparency for the color of the minor tick marks.
  • Thickness
    Specifies the thickness of the minor tick marks, in pixels.
• Tick Mark Length
  Specifies the length of the minor tick marks, in pixels.

Option

Specifies the other properties of the minor tick marks on the axis.

• Show Minor Tick Mark Labels
  Specifies whether to display the labels of the minor tick marks on the axis. If checked, the following properties will be enabled.
• Label Every N Minor Tick Marks
  Specifies the frequency at which the minor tick marks will be labeled.
• Number of Minor Labels
  Specifies how many minor tick mark labels to be displayed on the axis.
  • Auto
    If checked, all minor tick mark labels will be shown.
  • Fixed
    If checked, you can specify the number of the minor tick mark labels to be displayed on the axis.

Scale tab

Customizes the way in which to label the tick marks on the axis. Available only when the field on the category axis is one of the following types: Number, Date, DateTime, and Time, and not applied to scatter charts or when the category axis is used to show numeric data in bubble charts. See the tab.

Use Constant Interval

Specifies whether to use a constant interval to label the tick marks. If checked, the values of the tick marks will be increased continually on the axis based on the following properties, instead of just using the data values.

Minimum

Specifies the minimum value which will be used to label the tick marks.

• Auto
  If checked, the minimum value will be defined by JReport automatically.
• Fixed
  If checked, you can define the minimum value as required. Input the value in the text box, or specify it in the calendar if the field on the category axis is of Date, DateTime or Time type.

Maximum

Specifies the maximum value which will be used to label the tick marks.

• Auto
  If checked, the maximum value will be defined by JReport automatically.
• Fixed
  If checked, you can define the maximum value as required. Input the value in the text box, or specify it in the calendar if the field on the category axis is of Date, DateTime or Time type.

Major Unit

Specifies the unit between two adjacent major tick marks.

• Auto
  If checked, the unit will be defined by JReport automatically.
• Fixed
  If checked, you can define the unit as required. Input the value in the text box, or choose the desired one from the drop-down list if the field on the category axis is of Date, DateTime or Time type.

Minor Unit

Specifies the unit between two adjacent minor tick marks.

• Auto
  If checked, the unit will be defined by JReport automatically.
• Fixed
  If checked, you can define the unit as required. Input the value in the text box, or choose the desired one from the drop-down list if the field on the category axis is of the Date, DateTime or Time type.

Font tab

The tab consists of two sub tabs: major label tab and minor label tab.

Major Label tab

Specifies the font format of the major tick mark labels on the axis. See the tab.

Font

Specifies the font format of text in the major tick mark labels.

• Font list
  Lists all the available font faces that can be selected to apply to the text.
• Font Size
  Specifies the font size of the text.
• Font Color
  Specifies the font color of the text.

  To change the color, click the color image button to display the color palette in which you can select a color, or click More Colors to customize the color within a wider range in the Pick a Color dialog, or click More Fill Effects to customize in the Fill Effects dialog. You can also input the hexadecimal value of a color directly in the text box after #.

• Transparency
  Specifies the transparency of the text.
• Rotation
  Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
• Shearing
  Specifies the gradient of the text.

Effects

Specifies the special effects of text in the major tick mark labels.

• Style
  Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
• Strikethrough
  Specifies the style of the horizontal line with which the text is struck through. It can be one of the following: none, thin line, bold line, and double lines.
• Underline
  Specifies the style of the horizontal line under the text. It can be one of the following: none, single, single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
• Superscript
  Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is available.
• Embossed
  Makes the text appear to be raised off the page in relief.
• Outlined
  Displays the inner and outer borders of each character.
• Subscript
  Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is available.
• Engraved
  Makes the text appear to be imprinted or pressed into the page.
• Shadowed
  Adds a shadow beneath and to the right of the text.

Sample

Displays a sample of the specified font and any text effects.

Minor Label tab

Specifies the font format of the minor tick mark labels on the axis. See the tab.

Correlate with Major Label

If checked, the font format of the minor tick mark labels will correlate with that of the major tick mark labels automatically. Only when it is unchecked can the font properties of the minor tick mark labels take effect.

Font

Specifies the font format of text in the minor tick mark labels.

• Font list
  Lists all the available font faces that can be selected to apply to the text.
• Font Size
  Specifies the font size of the text.
• Font Color
  Specifies the font color of the text.

  To change the color, click the color image button to display the color palette in which you can select a color, or click More Colors to customize the color within a wider range in the Pick a Color dialog, or click More Fill Effects to customize in the Fill Effects dialog. You can also input the hexadecimal value of a color directly in the text box after #.

• Transparency
  Specifies the transparency of the text.
• Rotation
  Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
• Shearing
  Specifies the gradient of the text.

Effects

Specifies the special effects of text in the minor tick mark labels.

• Style
  Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
• Strikethrough
  Specifies the style of the horizontal line with which the text is struck through. It can be one of the following: none, thin line, bold line, and double lines.
• Underline
  Specifies the style of the horizontal line under the text. It can be one of the following: none, single, single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
• Superscript
  Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is available.
• Embossed
  Makes the text appear to be raised off the page in relief.
• Outlined
  Displays the inner and outer borders of each character.
• Subscript
  Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is available.
• Engraved
  Makes the text appear to be imprinted or pressed into the page.
• Shadowed
  Adds a shadow beneath and to the right of the text.

Sample

Orientation tab

The tab consists of two sub tabs: major label tab and minor label tab.

Major Label tab

Specifies the rotation angle of the major tick mark labels on the axis. See the tab.

Automatic

Specifies to adjust the rotation angle of the major tick mark label text on the axis automatically according to the length of the label text, in degrees.

When this option is checked by default:

• If the text can be completely displayed horizontally, the default rotation angle will be 0.
• If the text cannot be completely displayed horizontally, the default rotation angle will be 30 anticlockwise, and the cut off part will be shown as suspension points.

Angle

Specifies to customize the rotation angle of the major tick mark label text on the axis. When you change the rotation angle in the text box, the red line in the spin box will change correspondingly, and vice versa.

Minor Label tab

Specifies the rotation angle of the minor tick mark labels on the axis. See the tab.

Correlate with Major Label

If checked, the orientation setting of the minor tick mark labels will correlate with that of the major tick mark labels automatically. Only when it is unchecked can the orientation properties of the minor tick mark labels take effect.

Automatic

Specifies to adjust the rotation angle of the minor tick mark label text on the axis automatically according to the length of the label text, in degrees.

When this option is checked by default:

• If the text can be completely displayed horizontally, the default rotation angle will be 0.
• If the text cannot be completely displayed horizontally, the default rotation angle will be 30 anticlockwise, and the cut off part will be shown as suspension points.

Angle

Specifies to customize the rotation angle of the minor tick mark label text on the axis. When you change the rotation angle in the text box, the red line in the spin box will change correspondingly, and vice versa.

Format tab

The tab consists of two sub tabs: major label tab and minor label tab.

Major Label tab

Specifies the data format of the major tick mark labels on the axis. See the tab.

Category

Lists the category types. Select one to customize its format.

Format

Displays all the formats of the selected category. Select the required one and click Add to add it as the format of the specified category. You can add only one format for each category. For more details about the formats, see A detailed chart property reference.

Properties

Displays the properties of the format you select. If the formats listed in the Format box cannot meet your requirement, define the format in the text field and then click Add to add it as the format of the specified category.

Sample

Displays the selected format effects.

Stack

Lists all the formats you select from different categories.

Add

Adds a format to the Stack list box.

Remove

Removes a format from the Stack list box.

Apply

Applies the specified format in the Stack list box to the major tick mark labels.

Minor Label tab

Specifies the data format of the minor tick mark labels on the axis. See the tab.

Correlate with Major Label

If checked, the data format of the minor tick mark labels will correlate with that of the major tick mark labels automatically. Only when it is unchecked can the format properties of the minor tick mark labels take effect.

Category

Lists the category types. Select one to customize its format.

Format

Displays all the formats of the selected category. Select the required one and click Add to add it as the format of the specified category. You can add only one format for each category. For more details about the formats, see A detailed chart property reference.

Properties

Displays the properties of the format you select. If the formats listed in the Format box cannot meet your requirement, define the format in the text field and then click Add to add it as the format of the specified category.

Sample

Displays the selected format effects.

Stack

Lists all the formats you select from different categories.

Add

Adds a format to the Stack list box.

Remove

Removes a format from the Stack list box.

Apply

Applies the specified format in the Stack list box to the minor tick mark labels.

Behaviors tab

Specifies some web behaviors to the axis. See the tab.

Adds a new web behavior line.

Removes the selected web behavior.

Moves the selected web behavior up a step.

Moves the selected web behavior down a step.

Events

Specifies the trigger event.

Actions
Specifies the action you want the event to trigger.

• 
  Opens the Web Action List dialog to bind a web action to the event.

Related topics:

• Formatting the category axis