Tag name: <dvt:metricLabel>

Use the metricLabel tag to position the label for the gauge metric.

Relationship with other tags

The metricLabel tag is a child tag of the gauge tag.
The metricLabel tag has the following child tag: gaugeFont and numberFormat.


The following example shows the XML for a metricLabel tag.

      <dvt:metricLabel position="LP_BELOW_GAUGE" numberType="NT_PERCENT">
         <dvt:gaugeFont name="Tahoma" size="11" color="#3C3C3C" bold="true" italic="false"/> 


Name Type Supports EL? Description
id java.lang.String no Specifies the identifier for the component
position java.lang.String yes Specifies the location of the metric label, if any. Valid values:
  • LP_NONE - Displays no metric label.
  • LP_BELOW_GAUGE - Displays the metric label below the gauge. Note: If the position of both the bottom label and the metric label is set to LP_BELOW_GAUGE, then both labels are displayed below the gauge. However, the bottom label is displayed above the metric label.
  • LP_WITH_BOTTOM_LABEL - (Default) Displays the metric label beside the bottom label. Note: If the position of the bottom label is set to LP_NONE, the metric label will not be displayed.
  • LP_INSIDE_GAUGE - Displays the metric label inside the gauge. Note: Top, bottom, and metric labels are horizontally centered across a gauge. When these labels are positioned inside a gauge, they are also centered vertically within the gauge plot area.
numberType java.lang.String yes Format for numbers that are displayed in the metric label. Valid values are:
  • NT_NUMBER - (Default) Specifies that the actual value is displayed.
  • NT_PERCENT - Specifies that percentages are displayed and the axis is scaled from 0 to 100%.