Specifying other settings for gauges
When using the “Specify Gauge Settings” dialog box to create and configure gauges, these settings are all made on the “Other” tab. The “Other” tab includes settings for miscellaneous aspects of the gauge's appearance:
- “Data Value Cosmetics”
- “Tooltips”
When modifying a gauge by script, use the GaugeSetProperty method or the GaugeGetProperty method to make these settings. Use the GaugeProperty enumeration.
Data Value Cosmetics group
The “Data Value Cosmetics” group box contains settings that control the way data values display on a gauge.
This table lists the settings you can make for data value cosmetics on the “Other” tab. GaugeSetProperty and GaugeGetProperty property names are also listed.
| Other tab Fields / Options | Property name | Description / Comments |
|---|---|---|
| Font | ValueFont | Specify the font or font family to use for any data value text; for example, “Arial”. |
| Font Color | ValueFontColor | Specify the RGB
value for the data value font color, 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 data value font. The hexadecimal code displays after you click “” to exit the “Color” dialog box. |
| Font Size | ValueFontSize | Specify a font size, in points (0 to 72), for the data value text. |
| Font Bold | ValueFontBold | When selected (default), this option displays any data value text using the “Boldface” “ font attribute”. |
| Font Italic | ValueFontItalic | When selected, this option displays any data value text in italics. |
| Background Color | ValueBgColor | Specify the RGB
value for the data background color, 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 data value area background. The hexadecimal code displays after you click “” to exit the “Color” dialog box. To use a gradient fill, specify all the colors required for the gradient fill, separated by commas. |
| Border Color | ValueBorderColor | Specify the RGB
value for the data border color, 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 data value area border. The hexadecimal code displays after you click “” to exit the “Color” dialog box. |
| Alpha | ValueAlpha | Specify the transparency (0 to 100) to apply to the data value area in general. |
| Font Alpha | ValueFontAlpha | Specify the transparency (0 to 100) to apply to the data value text font. |
| Background Alpha | ValueBgAlpha | Specify the transparency (0 to 100) to apply to the data value area background. |
| Border Alpha | ValueBorderAlpha | Specify the transparency (0 to 100) to apply to the data value area border. |
| Border Thickness | ValueBorderThickness | Specify the thickness, in pixels, for the data value area border. |
| Border Radius | ValueBorderRadius | Specify the size of the corner radius, in pixels, to use for rounded corners on a data value area. |
| Border Is Dashed | ValueBorderDashed | When selected, specifies that the border around the data value area is to be dashed. |
| Border Dash Length | ValueBorderDashLen | Specify the length of the dash to use, in pixels, for the border around the data value area. |
| Border Dash Gap | ValueBorderDashGap | Specify the length of the gap between dashes to use, in pixels, for the border around the data value area. |
Tooltips group
The “Tooltips” group box contains settings that control the way tooltips display on a gauge.
This table lists the settings you can make for tooltips on the “Other” tab. GaugeSetProperty and GaugeGetProperty property names are also listed.
| Other tab Fields / Options | Property name | Description / Comments |
|---|---|---|
| Show Tooltip | ShowToolTip | When selected, this option displays tooltips when the pointer hovers over a data point. |
| Show Tooltip Shadow | ShowToolTipShadow | When selected, this option displays a drop shadow around tooltips. |
| Tooltip Back Color | ToolTipBgColor | Specify the RGB
value for the tooltip background color, 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 tooltip background. The hexadecimal code displays after you click “” to exit the “Color” dialog box. To use a gradient fill, specify all the colors required for the gradient fill, separated by commas. |
| Tooltip Border Color | ToolTipBorderColor | Specify the RGB
value for the tooltip border color, 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 tooltip border. The hexadecimal code displays after you click “” to exit the “Color” dialog box. |
For more information about these and other gauge properties, see the FusionCharts Developer help (www.fusioncharts.com/dev/).