Formatting the Indicators in an Indicator Chart
This topic describes how you can format the indicators in an indicator chart.
- Right-click an indicator in the indicator chart and select Format Indicator from the shortcut menu, or double-click any indicator in the chart. Designer displays the Format Indicator dialog box.
- In the General tab, specify the general properties of the indicators.
In the Style box, specify to use an indicator or multiple indicators to show each value in the chart.
In the Option box, set the left margin, top margin, range radius, and the shape of the indicators. If the indicator chart displays numeric values, select how to fill the indicators from the Fill Type drop-down list: select all to fill the whole indicator or based on max value to fill a portion of the indicators calculated based on the maximum value of the chart. When you select "based on max value", if a value is less than the minimum value, Designer does not fill the indicator; if a value is greater than the minimum value, Designer fills the portion of the value in the indicator which is divided by the maximum value.
In the Border box, select Show Border if you want to show the border of the indicators, then specify the properties of the border including the line style, thickness, color, and color transparency (to change the color, select the color indicator and select a color from the color palette, or type the hexadecimal value of a color in the text box).
If the indicator chart displays numeric values, in the Value box, specify the maximum and minimum values to display in the chart. By default, Designer calculates the minimum and maximum values based on the real values in the chart using certain algorithm, which is the meaning of the default value "Auto".
In the Value Label box, select Show Value to show the value labels for the indicators, then specify the position of the value labels relative to the indicators, and whether to scale big and small numbers in the values.
- In the Frame tab, specify the properties for the frame of the indicator chart.
In the Size box, specify the size of the frame.
In the Fill box, specify the color and the transparency of the color to fill the frame.
In the Border box, specify the properties for the border of the frame, including the type, color, line style, color transparency, thickness, ending style, line joint style, fill pattern, and dash size.
In the Category Label box, select Show Category Label to show the category labels for the indicators, which display the category value each indicator represents, and the position of the category labels relative to the indicators.
- In the Range Color tab, specify different colors or images to fill the indicators.
- If the indicator chart displays Boolean values, select the cell in the Color and Name columns to specify the colors from the color palette and the names for the two values in the indicator chart. If you want to use images to represent the two values, select Show Image, then select the cell in the Images column and select the ellipsis button in the cell to specify the images.
- If the indicator chart displays String or numeric values:
By default, Designer provides three predefined value ranges and calculates the minimum and maximum values for each range using certain algorithm, which is the meaning of the default value "Auto": if the indicator chart displays numeric values, Designer calculates the minimum and maximum values according to the minimum and maximum values that you specify in the General tab; if the indicator chart displays String values, Designer calculates the minimum and maximum values according to how many values there are in the chart and the alphabetic order of the values. You can select the corresponding cells to edit the minimum and maximum values, colors from the color palette, and names for the ranges according to your own requirements. Select the Add button to add and define more ranges, or select a range and select the Remove button to delete it if not required.
In the Others box, specify the name and color for the values that do not fall into any of the ranges you define.
If you want to use images to represent the values, select Show Image and specify the image for each value range and the Others value group respectively.
If you only edit the minimum and maximum values for one range but keep the default "Auto" value for all the rest ranges, Designer regards that there is only one value range in the indicator chart; therefore, you are recommended to either keep the default "Auto" value for all the ranges to let Designer calculates them for you, or edit them all to apply your own values.
- In the Hint tab, specify whether to include the category and series values and whether to scale big and small numbers in the indicator hint (you need to set the Show Tips property on the chart paper to "true" in the Report Inspector if you want to show the hint). A hint displays the value an indicator in the indicator chart represents when you point the mouse pointer at the indicator in Designer view mode, in HTML result, or at runtime.
- For an indicator chart in a library component, you can define web behaviors on the indicators in the Behaviors tab.
A web behavior contains a trigger event and a web action to be triggered when the event occurs on the indicators at runtime. You can add as many web behaviors to the indicators as you need.
To define the web behavior, select a trigger event from the drop-down list in the Events column, then select in the Actions column and select in the text box. In the Web Action List dialog box, bind a web action the same as you do to web controls in the library component. The web actions you can bind include Filter, Sort, Parameter, Property, and SendMessage.
You can select to add and define more web behaviors; if a web behavior is not required, select it and select to delete it. Select a web behavior and select or to adjust the order of the behaviors, then at runtime, when an event that is bound with more than one action happens, JDashboard triggers the upper action first.
- Select OK to accept the changes and close the dialog box.