#### A detailed chart property reference

##### Border Type

Specifies the border type of an object. The settings for Border Type are:

- none
  The object has no visible border lines (default value).
- raised
  The object has 3D borders that appear as if they are raised off the page.
- recess
  The object has 3D borders that appear as if they are pressed into the page.
- shadow
  The object has two shadowed borders, beneath and to the right of the object.
- solid
  The object has single-line borders.

##### Data Format

Specifies the data format for the labels of the axes or legend as required. Applies to chart platforms.

Click in the value cell and select the data format as required:

Format Type | Option | Description (Sample)
--- | --- | ---
Scale |  | Obtains a new value by a calculation on the value.
| Logarithm | Calculates ten to the power of the value.
| Hundreds | Divides the value by one hundred.
| Thousands | Divides the value by one thousand.
| Millions | Divides the value by one million.
| Billions | Divides the value by one billion.
| Trillions | Divides the value by one trillion.
Number |  | Re-formats the number value (original example: 123456)
| 0 | Formats a decimal number to an integer (123456).
| #,##0 | Formats a decimal number to a digit grouped integer (123,456).
| #,##0;-#,##0 | Formats a decimal number to a digit grouped integer. A minus sign is used as the negative prefix (123,456/-123,456).
| 0.00 | Formats a decimal number to a fixed-point number retaining 2 digits after decimal separator (123456.00).
| #,##0.00 | Formats a decimal number to a digit grouped number retaining 2 digits after decimal separator (123,456.00).
| #,##0.00;-#,##0.00 | Formats a decimal number to a digit grouped number retaining 2 digits after decimal separator. A minus sign is used as the negative prefix (123,456.00/-123,456.00).
| 0.00E00 | Formats a decimal number to a number in scientific notation. The mantissa is often in the range 1.0 <= x < 10.0, and the number of digit characters after the exponent character (E) gives the minimum exponent digit count (1.23E04).
| ##0.0E0 | Formats a decimal number to a number in scientific notation. The minimum number of integer in the mantissa is 1, and the number of digit characters after the exponent character (E) gives the minimum exponent digit count (12.34E3).
| $0 | Format a decimal number to an integer, prefixed with a currency symbol $ ($123456).
| $#,##0 | Formats a decimal number to a digit grouped integer, prefixed with a currency symbol $ ($123,456).
| $#,##0;-$#,##0 | Formats a decimal number to a digit grouped integer, prefixed with a currency symbol $. A minus sign is used as the negative prefix ($123,456/-$123,456).
| $0.00 | Formats a decimal number to a fixed-point number retaining 2 digits after decimal separator, prefixed with a currency symbol $ ($123456.00).
| $#,##0.00 | Formats a decimal number to a digit grouped number retaining 2 digits after decimal separator, prefixed with a currency symbol $ ($123,456.00).
| $#,##0.00; -$#,##0.00 | Formats a decimal number to a digit grouped number retaining 2 digits after decimal separator, prefixed with a currency symbol $. A minus sign is used as the negative prefix ($123,456.00/-$123,456.00).
| $0.00E00 | Formats a decimal number to a number in scientific notation, prefixed with a currency symbol $. The mantissa is often in the range 1.0 <= x < 10.0, and the number of digit characters after the exponent character (E) gives the minimum exponent digit count ($1.23E$04).
| $##0.0E0 | Formats a decimal number to a number in scientific notation, prefixed with a currency symbol $. The minimum number of integer in the mantissa is 1, and the number of digit characters after the exponent character (E) gives the minimum exponent digit count ($12.34E$3).
| 0% | Formats a decimal number to percentage: multiplied by 100 and shown as an integer percentage (12%).
| 0.00% | Formats a decimal number to percentage: multiplied by 100 and shown as a fixed-point number percentage retaining 2 digits after decimal separator (12.34%).
| Notes: The number of 0 that appears in a pattern indicates the minimum digits, show 0 if that digit is zero. The number of # that appears after the decimal point in a pattern indicates the maximum digits of decimal, zero shows as absent. Use ' (single quotation mark) to quote special characters in a prefix or suffix, for example, '#'# formats 123 to #123. To create the single quote itself, use two in a row: # o''clock.
Date/Time |  | Re-formats the date/time value (For example, Wednesday, December 25, 00:00:00 GMT-08:00 2002)
| G | Formats a date to era designator (AD).
| yyyy | Formats a date to year (2002).
| yy | Formats a date to year in short form (02).
| yyyy G | Formats a date to year, tagged with era designator (2002 AD)
| MM | Formats a date to month in year, shown in number format (12).
| MMM | Formats a date to month in year, shown in the abbreviated form (Dec).
| MMMMMMMM | Formats a date to month in year, shown in the full form (December).
| dd/MM/yy | Formats a date to a simple date form (25/12/02).
| dd-MMM-yy | Formats a date to a simple date form (25-Dec-02).
| dd-MMM | Formats a date to a simple date form (25-Dec).
| MMM-yy | Formats a date to a simple date form (Dec-02).
| MMM yyyy | Formats a date to a simple date form (Dec 2002).
| dd | Formats a date to day in month (25).
| DDD | Formats a date to day in year (359).
| ww | Formats a date to week in year (52).
| W | Formats a date to week in month (4).
| EEE | Formats a date to day in week, in short form (Wed).
| EEEEEE | Formats a date to day in week (Wednesday).
| HH | Formats a date to hour in day, 0~23 (00).
| kk | Formats a date to hour in day, 1~24 (24).
| KK a | Formats a date to hour in am/pm, 0~11, with am/pm marker (00 AM)
| hh a | Formats a date to hour in am/pm, 1~12, with am/pm marker (12 AM)
| mm | Formats a date to minute in hour (00).
| hh:mm a | Formats a date to hour in am/pm, 1~12, minutes in an hour, with am/pm marker (12:00 AM).
| ss | Formats a date to second in minute (00).
| hh:mm:ss | Formats a date to hour in am/pm 1~12, minutes in an hour, and second in minute (12:00:00).
| hh:mm:ss a | Formats a date to hour in am/pm 1~12, minutes in an hour, and second in minute, with am/pm marker (12:00:00 AM).
| mm:ss | Formats a date to minute in hour and second in minute (00:00).
| MMMMM dd yyyy G (EEEEEE) hh:mm:ss aa z | Formats a date to a full form date, which contains month in year (shown in full form), days in a month, year, era designator, day in week (shown in the full form), hour in a day, 1~12, minutes in an hour, second in minute, am/pm marker, and time zone (December 25 2002 AD (Wednesday) 12:00:00 AM GMT-08:00).
| Notes: Any characters in the pattern that are not in the ranges of ['a'..'z'] and ['A'..'Z'] will be treated as quoted text. For instance, characters such as ':', '.', ' ', '#' and '@' will appear in the resulting time text even they are not embraced within single quotes. A pattern containing any invalid pattern letter cannot be added to the filter stack.
Text |  | Specifies the length of the value.
| Default Length | Uses the length of the string Default Length, which is 14, as the length of the string. Any letters that exceed this length will be cut. You can modify this string, adding or deleting letters to increase or decrease the length limit. For example, type Teddy, the label displayed may probably be Wed D, which originally could be Wed December 25 2002. If you want to show all, you can type Teddy is a lovely bear!, where the length is longer than the length of string Wed December 25 2002.
Mapping |  | Maps new value to one or more values.
| One-to-one Mapping | Maps a new value to one value. Type the argument number that you want to replace, and then specify the new value in the Map to box. For example, if you want to replace the second data label on the X axis, which is Thu Jul 04 2002, with a new string US National Day, just type 2 in the Argument# box, type US National Day in the Map to box, and then click Add to add it to the Filter Stack. If you want to map more values, repeat this procedure.
| Range Mapping | Maps a new value to a range of values. Type the argument numbers to define the range you want to map together, and then specify the new value in the Map to box. For example, if you want to replace the data labels from the second one to the fifth with a new name My Holiday, just type 2 in the first Argument# box and 5 in the second Argument# box, then type My Holiday in the Map to box, and finally click Add to add it to the Stack. If you want to map ranges that are not consecutive, repeat this procedure.
| Text Mapping | Changes the data in the axis data label to a customized string. For example, if you want to change Chen in the first data label of the X axis to Jinfonet, type Chen in the Original Text box, type Jinfonet in the Map to box, and then click Add to add it to the Stack. You can only change the data one by one. Make sure that your spelling in the Original Text box is exactly the same as the data shown in the axis label.
| Prefix | Adds a string before the text in the data label of the axis. For example, if you want to add NA before the text in the data label of the X axis, type NA in the Map to box, and click Add to add it to the Stack.
| Suffix | Adds a string behind the text in the data label of the axis. For example, if you want to add NA behind the text in the data label of the X axis, type NA in the Map to box, and click Add to add it to the Stack.
| Note: The data labels along each axis count from 0, which means the number of the first data label you see on the axis will be 0, the second will be 1, the third will be 2, etc.

##### End Caps

Specifies the ending style of the border line. Can be one of the following:

- butt
  Ends unclosed subpaths and dash segments with no added decoration.
- round
  Ends unclosed subpaths and dash segments with a round decoration that has a radius equal to half of the width of the pen.
- square
  Ends unclosed subpaths and dash segments with a square projection that extends beyond the end of the segment to a distance equal to half of the line width.

##### Fill Type

Specifies the fill pattern of an object. Applies to chart platforms, chart paper, chart legends, walls, floors, axes, tick marks, labels, fonts and icons. Can be one of the following:

- none
  No fill (default).
- color
  Fills with a specified color.
- texture
  Fills with a specified texture.
- gradient
  Fills with gradient colors.
- image
  Fills with a specified image (not available for legend icons).

##### Font Effect

Specifies the special effect for the text. Applies to fonts. Can be one of the following:

- none
  Does not apply any special effect to the text (default).
- embossed
  Makes the text appearing as if it is raised off the page.
- engraved
  Makes the text appearing as if it is imprinted or pressed into the page.
- shadowed
  Adds a shadow behind, beneath and to the right of the text.
- outlined
  Displays the inner and outer borders of each character.
- shadowed & outlined
  Makes the text to be outlined and shadowed.

##### Font Script

Specifies superscript/subscript form for the text. Applies to fonts. Can be one of the following:

- none
  Does not apply superscript or subscript form to the text (default).
- superscript
  Makes the text to be shown above the baseline and changes it to a smaller size.
- subscript
  Makes the text to be shown below the baseline and changes it to a smaller size.

##### Font Strikethrough

Specifies the style for the horizontal line with which the text is struck through. Applies to fonts. Can be one of the following:

- none
  Does not draw any line through the text (default).
- thin Line
  Draws a normal line through the text.
- bold Line
  Draws a bold line through the text.
- double Lines
  Draws two lines through the text.

##### Font Underline

Specifies the style for the horizontal line under the text. Applies to fonts. Can be one of the following:

- none
  No underline (default).
- single
  Draws a single line under the text.
- single lower
  Draws a single line under the text at a lower position.
- bold line
  Draws a bold line under the text.
- bold lower
  Draws a bold line under the text at a lower position.
- double lines
  Draws two lines under the text.
- bold double
  Draws two bold lines under the text.
- patterned line
  Draws a line under the text, using the pattern of the text font.
- bold patterned
  Draws a bold line under the text, using the pattern of the text font.

##### Hyperlink

This property is used to add a hyperlink to the chart that refers to another report or a website. You can control the hyperlink property with a formula, which will be a good way to get required data from another report.

For example, you have two report sets A and B in the SampleReports.cat catalog. In report set A, the data in a banded object is grouped by customer country and a chart is used to illustrate the count of Customer_ID in every group. Report set B shows the information of customer, such as ID, Name, and Annual Sales. Now we build a link between the two reports. In JReport Web, run report set A, click the bar of a country, and report set B will appear, only showing the data of the specific country. The steps are:

1. Copy ReportB.cls and SampleReports.cat to a new folder. Launch JReport Enterprise Server and publish the folder to the server.
2. Start JReport Designer and open ReportA.cls. Create a new formula named Link_b. It might be:

       string t="http://localhost:8888/jrserver/test/SampleReports.cat/ReportB.cls?
       jrs.cmd=jrs.web_vw&jrs.authorization=YWRtaW46YWRtaW4%3D&";
       string t1="jrs.param$PCOUNTRY=";
       string url=t+t1+"@INNER+&jrs.result_type=1";
       return url

   Notes:

   - Make sure that the paths of the catalog and the report set in the URL are corresponding with their paths on the server.
   - The built-in parameter INNER is used for representing the category data. In addition, you can use OUTER for the series data.
   - For the X HyperLink and Z HyperLink properties, you can use @XDIM and @ZDIM respectively instead of @INNER and @OUTER.
3. In the Report Inspector, set the Hyperlink property of the chart platform to Link_b.
4. After publishing the report sets and catalog, run report set A, point to a bar and click it, the corresponding records will be displayed. You can also view the information of the other countries by clicking the corresponding bars in report set A.

##### Style List

Specifies the style for the icon of each category name. The icon style for each category name can be different. Applies to legend icon.

Type the icon style codes side by side in the Style List property entry to define the icon style for each icon. An icon style code is a two-digit number standing for an icon style. For instance, use string 00010203, the 1st icon will change to a rectangle, 2nd to a diamond, 3rd to an upward triangle, and 4th to a downward triangle.

The icon style codes are:

Code | Description
--- | ---
00 | Rectangle.
01 | Diamond.
02 | Triangle Up.
03 | Triangle Down.
04 | Triangle Left.
05 | Triangle Right.
06 | Circle.
07 | Cross1. Cross in the form of "+".
08 | Cross2. Cross in the form of "x".

##### Image Layout

Specifies the layout style of an image. Applies to images. Can be one of the following:

- tile
  Repeats the image over the entire area (default).
- center
  Displays the image in the center of the area.
- scaled
  Stretches the image to cover the entire area.

##### Line Joint

Specifies the line joint style. Can be one of the following:

- miter
  Joins path segments by extending their outside edges until they meet.
- round
  Joins path segments by rounding off the corner at a radius of half the line width.
- bevel
  Joins path segments by connecting the outer corners of their wide outlines with a straight segment.

##### Start Offset(1st.Data.Set), End Offset(1st.Data.Set), Start Offset(2nd.Data.Set), and End Offset(2nd.Data.Set)

These four properties are used to control the data source range that appears on the chart.

For 2-level-group charts, record-level charts and all kinds of combination charts, Start Offset(1st.Data.Set) and End Offset(1st.Data.Set) are used to control the starting offset and ending offset of the data series; Start Offset(2ndDataSet) and End Offset(2nd Data.Set) are used to control the range of the categories.

For 1-level-group charts, Start Offset(2nd.Data.Set) and End Offset(2nd.Data.Set) are used to control the starting offset and ending offset of the categories; Start Offset(1st.Data.Set) and End Offset(1st.Data.Set) will not work because there is no series data in chart that contains only one group.

The range of the property values can be -1 (Default, Not Set) or an integer between 0 and Number of Data Series – 1 (or, Number of Categories - 1).

If the value is out of this range, the following rules will be applied to the default value:

IF | THEN
--- | ---
Start Offset(1st.Data.Set) < 0 | Start Offset(1st.Data.Set) = 0
Start Offset(1st.Data.Set) > max data number | Start Offset(1st.Data.Set) = max data number
End Offset(1st.Data.Set) < 0 | End Offset(1st.Data.Set) = max data number
End Offset(1st.Data.Set) > max data number | End Offset(1st.Data.Set) = max data number
Start Offset(1st.Data.Set) > End Offset(1st.Data.Set) and EndOffset(1st.Data.Set) >=0 | Start Offset(1st.Data.Set) = 0, End Offset(1st.Data.Set) = max data number

Same rules apply to Start Offset(2nd.Data.Set) and End Offset(2nd.Data.Set).

##### Threshold Line Style

Specifies the style for the threshold lines. Applies to Chart Paper. Note that Stock Charts, Radar Charts, Scatter Charts, and Bubble Charts have no threshold lines.

A threshold line marks a specific data point that is specified by the user. It is usually used by the user for comparing with data series to see whether the data is higher or lower than this point. For example, if you want to see whether the production zones successfully accomplished their production tasks, you can set a threshold line to represent the goal output, and another to represent the lowest acceptable output quantity. By using the threshold lines, you can spot out the zones that are out of the range at a glance.

For 3-D chart, the threshold line value is represented by a plane.

Can be one of the following:

Option | Description
--- | ---
Style1 | Use two threshold areas (Threshold Line1 and Threshold Line2) to emphasize the data series that are higher than the first threshold line or lower than the second threshold line.
Style2 | Use a single threshold area (Threshold Line1) to emphasize the data series that are between the higher and the lower threshold lines.