<dvt:metricLabel>

metricLabel metric label


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 tags: dvt:gaugeFont, dvt:numberFormat(deprecated) and af:convertNumber.

Note: The use of <dvt:numberFormat> is now replaced with <af:convertNumber> tag.

Example

The following example shows the XML for a metricLabel tag.

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

Attributes

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%.
scaling java.lang.String yes Scaling factor for numbers that are displayed. Valid values are:
  • auto - (Default) The number will be scaled automatically.
  • none - The number will not be scaled.
  • thousand - The number will be scaled to thousands.
  • million - The number will be scaled to millions.
  • billion - The number will be scaled to billions.
  • trillion - The number will be scaled to trillions.
  • quadrillion - The number will be scaled to quadrillions.
autoPrecision java.lang.String yes Whether to turn on the automatic precision for decimal digits. Valid values are:
  • on - (Default) The number of decimal digits are determined automatically.
  • off - The number of digits is based on the user specification from af:convertNumber