<dvt:referenceObject>

referenceObject reference object


Use the referenceObject tag to define a reference line or a reference area for a graph. You can define an unlimited number of reference objects for a given graph. This tag should be wrapped by the referenceObjectSet tag.

Relationship with other tags

The referenceObject tag is a child tag of the referenceObjectSet tag.

Example

The following example shows the XML for a referenceObject tag that .


        <dvt:graph value ="#{sampleGraph.graphDataModel}" graphType="BAR_VERT_CLUST2Y" imageType="IMAGE_TYPE_SVG"  stylePath="/oracle/dss/graph/styles/april.xml" 
          y1ReferenceObjectDisplay="RO_DISPLAY_AUTOMATIC" y2ReferenceObjectDisplay="RO_DISPLAY_AUTOMATIC" seriesReferenceObjectDisplay="RO_DISPLAY_AUTOMATIC">
          <dvt:referenceObjectSet>
          <dvt:referenceObject index="1" type="RO_AREA" association="Y1AXIS" location="RO_BACK" color="#55FF0000" lowValue="0" highValue="4000"/>
          <dvt:referenceObject index="2" type="RO_AREA" association="Y1AXIS" location="RO_BACK" color="#55FFFF00"  lowValue="4000" highValue="10000"/>
          <dvt:referenceObject index="3" type="RO_AREA" association="Y1AXIS" location="RO_BACK" color="#5500FF00"  lowValue="10000" highValue="18000"/>
          <dvt:referenceObject index="4" type="RO_AREA" association="Y2AXIS" location="RO_FRONT" color="#550000FF" lowValue="300" highValue="700"/>
     <dvt:referenceObject index="5" type="RO_LINE" association="SERIES" series="0" location="RO_FRONT" color="#ffff66" lineValue="5000" lineWidth="3" lineStyle="LS_SOLID"/>
     <dvt:referenceObject index="6" type="RO_LINE" association="SERIES" series="0" location="RO_FRONT" color="#ffff66" lineValue="16730" lineWidth="3" lineStyle="LS_SOLID"/>
     <dvt:referenceObject index="7" type="RO_LINE" association="SERIES" series="1" location="RO_BACK" color="#99cc66" lineValue="500" lineWidth="3" lineStyle="LS_SOLID"/>
     <dvt:referenceObject index="8" type="RO_LINE" association="SERIES" series="1" location="RO_BACK" color="#99cc66" lineValue="1711" lineWidth="3" lineStyle="LS_SOLID"/>
          </dvt:referenceObjectSet> 
          </dvt:graph>

Attributes

Name Type Supports EL? Description
id java.lang.String no Specifies the identifier for the component
index java.lang.String no Uniquely identifies a reference object within a specific reference object set.
type java.lang.String no

Identifies whether the reference object represents a line or an area. Valid values are:

  • RO_LINE - (Default) Specifies a reference line.
  • RO_AREA - Specifies a reference area.
location java.lang.String no

Specifies whether the reference line is to appear in front of or behind the graph. Valid values are:

  • RO_BACK - Reference line appears behind the graph.
  • RO_FRONT - Reference line appears in front of the graph.
association java.lang.String no

A constant that identifies the component that this reference object is associated with. The component is either an axis or a series. Valid values are the following:

  • Y1AXIS - (Default) Reference object is associated with the y1-axis.
  • Y2AXIS - Reference object is associated with the y2-axis.
  • X1AXIS - Reference object is associated with the x-axis.
  • SERIES - Reference object is associated with a data series.
series int no The zero-based index of the series that this reference object is associated. Does not apply to reference areas. Default value is "0".
color java.lang.String no Specifies the color for the reference object. Enter values in RGB hexadecimal.
lineWidth int no Specifies the width of the reference line in pixels. Does not apply to reference areas.
lineStyle java.lang.String no

Specifies the type of lineto be displayed for this reference object. Does not apply to reference area. Valid values are:

  • LS_SOLID - (Default) Displays a solid reference line.
  • LS_DASH - Displays a dashed reference line.
  • LS_DOTTED - Displays a dotted reference line.
  • LS_DASH_DOT - Displays a reference line that alternates between dash and dot.
text java.lang.String no Specifies the text that is to appear in the legend for this reference object.
lineValue double no Specifies the value at which the reference line is displayed. Does not apply to reference areas
lowValue double no Identifies the low end of the range of values for the area covered by this reference area. Does not apply to reference lines.
highValue double no Identifies the high end of the range of values for the area covered by this reference area. Does not apply to reference lines.
displayedInLegend boolean no

Indicates whether the reference object is to be displayed in the legend. Valid values are:

  • "true" - Displays the reference object in the legend.
  • "false" - Does not display the reference object in the legend