Summary

Tag name: <dvt:timeSelector>

Use the timeSelector tag to select a certain time range on a time axis. Typically used in a master-detail graphs. The selected time range in the master graph is displayed in the detail graph.

Relationship with other tags

The timeSelector tag is a child tag of the graph tag.

The timeSelector tag can have the following child tag: specialEffects.

Example

The following example shows the XML for a timeSelector tag.

   <dvt:graph> 
      <dvt:timeSelector explicitStart="#{sampleGraph.startDate}" explicitEnd="#{sampleGraph.endDate}" borderColor="#cccccc" borderTransparent="false" mode="EXPLICIT" fillColor="#ffffff" fillTransparent="false"/> 
   </dvt:graph>

Attributes

Name Type Supports EL? Description
id java.lang.String no Specifies the unique identifier for the component.
fillColor java.lang.String yes Specifies the color of the fill for the time selector. Enter values in RGB hexadecimal. The example color="#000000" specifies black color. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque.
borderColor java.lang.String yes Specifies the color of the border for the time selector. Enter values in RGB hexadecimal. The example color="#000000" specifies black color. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque.
borderTransparent boolean yes Indicates whether the border of the time selector is transparent. To make the time selector transparent, set both the borderTransparent and fillTransparent attributes to "true". Valid values are:
  • true - (Default) If the border of the time selector is transparent.
  • false - If the border of the time selector is visible.
Note: When an attribute or an object is transparent, it is not visible, but you can select it.
fillTransparent boolean yes Indicates whether the fill of the time selector is transparent. To make the time selector transparent, set both the borderTransparent and fillTransparent attributes to "true". Valid values are:
  • true - If the time selector is transparent.
  • false - (Default) If the time selector is visible.
Note: When an attribute or an object is transparent, it is not visible, but you can select it.
explicitStart java.util.Date only EL Specifies the explicit start date for the time selector. Mode must be set to EXPLICIT. Only value-binding is supported for this property.
explicitEnd java.util.Date only EL Specifies the explicit end date for the time selector. Mode must be set to EXPLICIT. Only value-binding is supported for this property.
mode java.lang.String yes Indicates the mode of the time selector. Valid values are:
  • TSM_OFF - (Default) which means do not show the time selector.
  • TSM_EXPLICIT - is used for setting explicit time range. On a time axis, you can specify an explicit time range to show up on the time selector.
timeSelectorListener java.lang.String no The listener interface for receiving time selector events on the graph. The TimeSelectorEvent contains information about the new extents of the time selector. Here is an example of timeSelectorListener implementation that displays the range of the time selector - 
    public void timeSelectorListener (TimeSelectorEvent event){
        Date startTime = new Date(event.getStartTime());
        Date endTime = new Date(event.getEndTime());
        System.out.println("The time selector range is from "+startTime.toString()+" to "+endTime.toString());
    }