Last Updated: 3/4/97
Class NFTimeChartApp

Class NFTimeChartApp

public class NFTimeChartApp extends Applet

This chart supports the display of tasks that have a defined starting and ending value. The X values may be specified using date expressions, time unit expressions, or numeric values. See Date/Time Values for details concerning the use of date time values.

This chart displays one or more datasets, each consisting of one or more tasks. A given data set is displayed as a horizontal line of boxes, where each box spans a range of X values from the starting value to the ending value. Each dataset can be assigned a color, that will be used as the color for each task in that data set or each task can be assigned an arbitrary color representing, for example, the status of that specific task. Furthermore, each task can be assigned an optional label to distinguish one task from another.

When the axis scrolling and zooming capability is utilized, the Time Chart can be used to show a wide range of projects over a wide range of time.

The following standard parameters are supported by this chart:

 	Background

 	Header
 	HeaderBox
 	Footer
 	FooterBox
 	LeftTitle
 	LeftTitleBox
 	RightTitle
 	RightTitleBox

 	DwellLabel
 	DwellBox
 	ActiveClicks
 	ActiveLabels[1-50]

 	Legend
 	LegendBox
 	LegendItems

 	TopAxis
 	LeftAxis
 	RightAxis
 	BottomAxis

 	Grid
 	GridLine
 	GridAxis

 	ColorTable

 	NoteSets
 	NoteSets[1-20]
 	NoteArrow
 	NoteAxis
 	NoteLabel
 	NoteBox

The following parameters are specifically supported by this chart:

DataSets = ("Name1", Color1, Border1, Width1, Image1),...;

 	Defines a list of datasets with the given name and color.

 	If a color is not specified in the vector, then the 
 	previously specified color will be used. If the color is
 	specified as "null", then a default color will be chosen
 	from the color table. (See the ColorTable parameter.)

 	The Color, Border, Width and Image attributes define the
 	default display attributes for each task box in the data
 	set. See Region Parameters for more details.

DataAxis = (XAxis1, YAxis1), (XAxis2, YAxis2), ...;

 	The XAxis and YAxis attributes define the specific axis
 	to be used when mapping the X and Y values respectively
 	for each data set defined. The XAxis attribute may be 
 	set to BOTTOM or TOP, while the YAxis may be set to LEFT
 	or RIGHT.

DataSet[1-50] = (start1, end1, "label1", color1),...;

 	Defines a list of tasks for the given data set.  Each task
 	is drawn as a box extending from the given start date/time
 	to the end date/time.

 	If the color value is defined for a given task, it will
 	override the default color assigned to the given dataset
 	in the DataSets parameter.

 	See Date/Time Values for details concerning
 	the use of date/time values.

 	See Axis Parameters for details concerning
 	the scrolling and zooming of axis values over a given range.

The following HTML segment defines a Time Chart depicting the tasks assigned to four different people over a 3 month period of time.

 	<applet code=NFTimeChartApp.class width=800 height=300>
 	<param	name=NFParamScript value = '

 	DataSets  = ("Fred",  null, SHADOW, 4),
 		    ("Sally", null, RAISED),
 		    ("Oscar", null, SHADOW, 4),
 		    ("Sammy", null, RAISED);

 	DataSet1  = ("1 Apr 96", 10, blue, "Coding"),
 		    ("15d 12h", "12h 30m", null, ""),
 		    ("1 May 96", "5 May 96",, "Testing");

 	DataSet2  = (5, 7), (15, 23);
 	DataSet3  = (5, 7), (15, 23, red, "Training");
 	DataSet4  = (5, 7), (15, 23);

 	TopFormat = (DATE, "%W\n%M/%D", "10 Apr 96", "1d");
 	TopTics	  = ("ON", black, "TimesRoman", 14);
 	TopScale  = ("1 Apr 96", "1 Jun 96", "7d");
 	TopScroll = (0, 90);

 	LeftTics  = ("ON", black, "TimesRoman", 16);

 	Legend	  = ("", black, "TimesRoman", 12);
 	LegendBox = (lightGray, SHADOW, 5);

 	'>
 	</applet>

Instance Variables

Type Name Description Default
public NFTimeChart Underlying time chart object timechart