IPFGauge formatter
This formatter shows a single numeric value as a gauge.
Because the IPFGauge formatter has many attribute options, they are grouped into tabs. For information about a specific option in the FDF Editor, click in the field to see the context-sensitive help.
Main Attributes tab
Specify information about the content and appearance of the gauge: type, height and width, lower and upper limits, whether the gauge shows values, how tick marks are shown, and so on.
If you specify a value for Fusion Chart XML, which is used for visual customization of the gauge, see the FusionWidgets documentation for details on advanced customization.
Angular Options tab
This tab is displayed when you select a gauge type of Angular. Use it to specify the inner and outer radius and start and end angles.
LED Options tab
This tab is displayed when you select a gauge type of Horizontal LED or Vertical LED. Use it to specify the LED size and LED gap.
Gauge Areas tab
The fields on this tab define the boundaries of a region in the gauge (the starting and ending numbers on the gauge scale that indicate where the region begins and ends), as well as the text to display in that region. Styles are defined using an attribute of the style definition.
Color regions apply to all gauge types except cylinder and thermometer.
Styling
While the IPFGauge formatter controls gauge type and some parameters, most of the visual customization is done using IPF Styles.
The style contexts shown in this table are used to support styling gauges:
| Style content | Description | Applies to |
|---|---|---|
| gauge | The style used applies to the gauge as a whole. In the cylinder and thermometer gauges, it applies to the fill color used to mark the value. | ipf-backgroundcolor
ipf-border ipf-fontstyle-italic ipf-fontweight-bold |
| gauge-areas | This suffix sets text color and styles for the labels within all gauge areas defined in the Field Display Formatter XML. This assumes that the type of gauge used is bulb or horizontal linear, because only these gauge types can have labels within their gauge areas. These styles override existing styles that apply to the whole gauge. | ipf-fontstyle-italic
ipf-fontweight-bold ipf-textcolor |
| gauge-area-integer | This sets the background color for each
gauge area region defined in the Field Display Formatter XML. Because there can
be multiple gauge area regions defined in a single gauge, you can further
suffix this style suffix by number to make it unique.
For example: ipf-backgroundcolor-gauge-area-2 If an ipf-backgroundcolor style is already set for the gauge contexts, an ipf-background color style set for this gauge area will create a border around the region using the given color. |
ipf-backgroundcolor |
| gauge-pointer | Applies to the gauge needle of the angular gauge and the pointer on the horizontal linear gauge. | ipf-backgroundcolor
ipf-border |
| gauge-major-tickmark | Applies to the major tick marks found in all gauge types except the bulb. | ipf-backgroundcolor |
| gauge-minor-tickmark | Applies to the minor tick marks found in all gauge types except the bulb. | ipf-backgroundcolor |