Specifying other settings for charts
When using the Specify Chart Settings dialog box to create and configure charts, these settings are all made on the Other tab. This tab is used for settings that do not clearly belong to any other tab or group.
This tab includes these groups of settings:
- Stacked charts
- Scroll charts
- Bar charts
- Anchors
- Number formatting
- Divisional lines
When modifying a chart by script, use the ChartSetProperty method or the ChartGetProperty method to make these settings. Use the ChartProperty enumeration.
Stacked Charts group
This table lists the settings you can make in the Stacked Charts group box of the Other tab. ChartSetProperty and ChartGetProperty attribute names are also listed. These settings apply only to stacked chart types.
| Other tab Field / Option | Attribute Name | Description / Comments |
|---|---|---|
| Show Sum | ShowSum | When selected,
this option specifies that the sum of all stacked data segments is to be
displayed.
Otherwise, the sum is not displayed. |
| Stack 100 Percent | Stack100Percent | When selected,
this option specified that the chart is to be rendered as 100% stacked chart.
This means that each column displays as a 100% total, with each stack segment represented as a percent of the total. Otherwise, the chart displays as a normal stacked chart with columns of varying heights. |
| Show Percent Values | ShowPercentValues | When selected,
this option specifies that the percent values are to be displayed on each
segment of the stack.
Note: To show absolute data values, rather than
percents, use the Show Values option on the
General tab,
Functional
Attributes group. If that value and this one are both set, this one
takes precedence.
|
| Show Percent In ToolTip | ShowPercentInToolTip | When selected,
this option specifies that the percent values are to be displayed in tooltips.
Otherwise, the tooltips display the absolute values. |
Scroll Charts group
Scroll charts are charts that can display data for more data plots than the width of the chart would normally allow. Users can view the additional data plots by scrolling the display left or right.
This table lists the settings you can make in the Scroll Charts group box of the Other tab. ChartSetProperty and ChartGetProperty attribute names are also listed. These settings apply only to scroll chart types.
| Other tab Field / Option | Attribute Name | Description / Comments |
|---|---|---|
| Visible Columns | NumVisiblePlot | Specify the number of columns that are to be visible in the canvas area when the chart is rendered. |
Bar Charts group
This table lists the settings you can make in the Bar Charts group box of the Other tab. ChartSetProperty and ChartGetProperty attribute names are also listed. These settings apply only to bar chart types.
| Other tab Field / Option | Attribute Name | Description / Comments |
|---|---|---|
| X-Axis Name Width | XAxisNameWidth | Specify, in
pixels, the maximum width that the X-axis name can be.
Anything beyond this width is truncated. |
| Max Label Width Percent | MaxLabelWidthPercent | Specify, as a percent, the maximum width the X-axis name label can occuply within the name area. |
| Center X-Axis Name | CenterXaxisName | When selected,
this option specifies that the X-axis name is to be centered.
Otherwise, this name displays at the top. |
| Rotate X-Axis Name | RotateYAxisName | When selected (default), this option specifies that the X-axis name is to be rotated 90 degrees (usually to conserve horizontal space). |
Anchors group
Anchors are used to display distinct data points in line, spline, and area charts. These anchors help to identify the data points better in the chart. They also display a tooltip that shows the data plot details.
This table lists the settings you can make in the Anchors group box of the Other tab. ChartSetProperty and ChartGetProperty attribute names are also listed. These settings apply only to line, spline, and area chart types.
| Other tab Field / Option | Attribute Name | Description / Comments |
|---|---|---|
| Draw Anchors | DrawAnchors | When selected
(default), this option specifies that the anchors are to be displayed.
Otherwise, anchors are hidden. |
| Anchor Sides | AnchorSides | Specify the
number of sides each anchor is to have.
This depends on how you want the anchors to display. For example, a setting of 3 here causes anchors to display as triangles, 4 as squares, and so on. Valid values range from 3 to 20. If this value is not specified, anchors render as circles. |
| Anchor Radius | AnchorRadius | Specify, in
pixels, how large the radius of each anchor is to be.
The greater this number is, the larger the anchor displays. |
| Border Color | AnchorBorderColor | Specify the RGB
value for the color of the anchor border, as a hexadecimal value
(000000-FFFFFF).
You can double-click to display the Color dialog box, where you can select a color or define a custom color for the anchor border. The hexadecimal code displays after you click to exit the Color dialog box. |
| Border Thickness | AnchorBorderThickness | Specify, in pixels, the thickness of the anchor border. |
| Back Color | AnchorBgColor | Specify the RGB
value for the background (or fill) color of the anchor, as a hexadecimal value
(000000-FFFFFF).
You can double-click to display the Color dialog box, where you can select a color or define a custom background color for the anchor. The hexadecimal code displays after you click to exit the Color dialog box. To use a gradient background fill, specify multiple hexadecimal values, separated by commas. |
| Alpha | AnchorAlpha | Specify the transparency for the anchor, from 0 (transparent) to 100 (opaque). |
| Back Alpha | AnchorBgAlpha | For each color you specified for the background, specify the transparency, from 0 (transparent) to 100 (opaque). If you are using multiple values (for a gradient fill), separate the alpha values by commas. |
Number Formatting group
This table lists the settings you can make in the Number Formatting group box of the Other tab. ChartSetProperty and ChartGetProperty attribute names are also listed. These settings apply only to number values. Unless otherwise stated, they apply to all number values displayed on the chart.
| Other tab Field / Option | Attribute Name | Description / Comments |
|---|---|---|
| Format Number | FormatNumber | When selected
(default), this option specifies that numbers are to be formatted with
commas (Thousand Separators).
Otherwise, numbers are displayed without separators. |
| Format Number Scale | FormatNumberScale | When selected
(default), this option specifies that numbers are to be displayed with a
trailing
K (for thousands) or
an
M (for millions)
after being truncated and rounded.
Otherwise, numbers are not truncated and rounded. |
| Force Decimals | ForceDecimals | When selected,
this option specifies that all numbers on the chart should display with the
designated number of decimal places, even if only some or no decimal places are
needed. This option adds zeroes, if necessary, to ensure that the designated
number of decimal places display.
Otherwise, all numbers display with only the number of decimal places required. |
| Force Y-Axis Decimals | ForceYAxisValueDecimals | When selected,
this option specifies that all numbers on the Y-axis should display with the
designated number of decimal places, even if some or no decimal places are
needed. This option adds zeroes, if necessary, to ensure that the designated
number of decimal places display.
Otherwise, Y-axis numbers display with only the number of decimal places required. |
| Default Number Scale | DefaultNumberScale | Specify the
unit that should be interpreted as the default value for any numbers.
For example, if the numbers to be formatted represent the number of seconds in a time sequence, then you would specify seconds in this field. |
| Number Scale Unit | NumberScaleUnit | Specify the
units of conversion to be used when converting numbers from lesser units to
greater units. Specify units using a comma-separated list.
For example, to change the way numbers are displayed based on their values, you can specify a Thousands to Millions to Billions conversion sequence. To do this, you would specify K, M, B in this field. To make time conversions (minutes to hours to days to weeks, for example), you would specify Min, Hr, Day, Wk in this field. This specification must be used in conjunction with the Number Scale Value specification. Note: The default number scale unit used is
thousands to millions (K, M).
|
| Number Scale Value | NumberScaleValue | Specify the
conversion ratio to use from one unit to the next unit. You must have one value
here for each unit specified in the
Number Scale Unit
field. Specify these values using a comma-separated list.
For example, to convert from thousands to millions to billions, you would specify 1000, 1000, 1000 in this field. To convert from the default of seconds to minutes to hours to days to weeks, you specify 60, 60, 24, 7 in this field. This specification must be used in conjunction with the Number Scale Unit specification. Note: The default number scale value used is
thousands to millions (1000, 1000).
|
| Number Prefix | NumberPrefix | Specify the
prefix to be used with all numbers on the chart.
For example, if all numbers represent money amounts in dollars, you would specify the dollar sign ($) in this field. |
| Number Suffix | NumberSuffix | Specify the
suffix to be used with all numbers on the chart.
For example, if all numbers represent an amount produced in a year's time, you would specify per year or /yr in this field. |
| Decimal Separator | DecimalSeparator | Specify the
character to be used as the decimal separator in numbers.
For example, in some countries, a period (which is the system default) is used to separate whole numbers from decimal parts. In other countries, a comma is used for this purpose. In this latter case, you would specify a comma (,) in this field. |
| Thousand Separator | ThousandSeparator | Specify the
character to be used as the thousands separator in numbers.
For example, in some countries, a comma (which is the system default) is used to separate whole numbers with more than three digits with commas every three digits. In other countries, a period is used for this purpose. In this latter case, you would specify a period (.) in this field. |
| Th. Separator Position | ThousandSeparatorPosition | Specify the
number of digits after which the thousand separator character should be placed.
You can use multiple values, separated by commas.
For example, if you were to specify 2,3 in this field, a number with nine digits would be formatted with a comma between the second and third digit from the right, and every third digit after that. If the number to be formatted were 123456789, it would be formatted as 1,234,567,89. |
| Decimal Places | Decimals | Specify the number of decimal places to which all numbers on the chart are to be rounded. The valid range is from 0 to 10. |
| Y-Axis Decimal Places | YAxisValueDecimals | Specify the
decimal precision of the div line values. The valid range is from 0 to 10.
Note: This option is only functional if you have
opted not to adjust the vertical div lines. For more information, see the next
section.
|
Divisional Lines group
This table lists the settings you can make in the Divisional Lines group box of the Other tab. ChartSetProperty and ChartGetProperty attribute names are also listed.
| Other tab Field / Option | Attribute Name | Description / Comments |
|---|---|---|
| Num Div Lines | NumDivLines | Specify the number of divisional lines to render on the chart. |
| Div Line Color | DivLineColor | Specify the RGB
value for the color of the divisional lines, as a hexadecimal value
(000000-FFFFFF).
You can double-click to display the Color dialog box, where you can select a color or define a custom color for the divisional lines. The hexadecimal code displays after you click to exit the Color dialog box. |
| Div Line Thickness | DivLineThickness | Specify, in pixels, the thickness of the divisional lines. |
| Div Line Alpha | DivLineAlpha | Specify the transparency for the divisional lines, from 0 (transparent) to 100 (opaque). |
| Div Line Is Dashed | DivLineIsDashed | When selected, this option specifies that the divisional lines should be dashed rather than solid. |
| Div LIne Dash
Length
Div Line Dash Gap |
DivLineDashLen
DivLineDashGap |
If the Div Line Is Dashed option is selected, use these settings to specify the length of each dash and the gaps between dashes. |
| Zero Plane Color | ZeroPlaneColor | Specify the RGB
value for the color of the zero plane, as a hexadecimal value (000000-FFFFFF).
Note: The zero plane is a line or plane that runs
between the positive and negative numbers on the Y-axis of a chart. Zero planes
are rendered by default in charts that plot both positive and negative values.
You can double-click to display the Color dialog box, where you can select a color or define a custom color for the zero plane. The hexadecimal code displays after you click to exit the Color dialog box. |
| Zero Plane Thickness | ZeroPlaneThickness | Specify, in pixels, the thickness of the zero plane. |
| Zero Plane Alpha | ZeroPlaneAlpha | Specify the transparency for the zero plane, from 0 (transparent) to 100 (opaque). |
| Show Alternate H-Grid Color | ShowAlternateHGridColor | When selected
(default), this option specifies that horizontal divisions are to be
represented by bands of alternating white and a color.
Otherwise, only divisional lines display, with no colored bands between them. |
| Alternate H-Grid Color | AlternateHGridColor | Specify the RGB
value for the color of the horizontal bands, as a hexadecimal value
(000000-FFFFFF).
You can double-click to display the Color dialog box, where you can select a color or define a custom color for the horizontal bands. The hexadecimal code displays after you click to exit the Color dialog box. |
| Alternate H-Grid Alpha | AlternateHGridAlpha | Specify the transparency for the horizontal bands, from 0 (transparent) to 100 (opaque). |
| Show Alternate V-Grid Color | ShowAlternateVGridColor | When selected
(default), this option specifies that vertical divisions are to be represented
by bands of alternating white and a color.
Otherwise, only divisional lines display, with no colored bands between them. |
| Alternate V-Grid Color | AlternateVGridColor | Specify the RGB
value for the color of the vertical bands, as a hexadecimal value
(000000-FFFFFF).
You can double-click to display the Color dialog box, where you can select a color or define a custom color for the vertical bands. The hexadecimal code displays after you click to exit the Color dialog box. |
| Alternate V-Grid Alpha | AlternateVGridAlpha | Specify the transparency for the vertical bands, from 0 (transparent) to 100 (opaque). |
| Show Zero Plane | ShowZeroPlane | When selected
(default), this option specifies that the zero plane is to be displayed on the
chart.
Otherwise, the zero plane is hidden. |
For more information about these and other chart attributes, see the FusionCharts Developer help (www.fusioncharts.com/dev/).