Time Scale Axis Properties

MajorGridTickInterval

This property controls major grids and ticks on interval (seconds to years) boundries in a chart that uses a time scale axis.

DATA TYPE:

integer

RANGE:

0...8

TIME_INTERVAL_UNDEFINED = 0
TIME_INTERVAL_SECONDS = 1
TIME_INTERVAL_MINUTES = 2
TIME_INTERVAL_HOURS = 3
TIME_INTERVAL_DAYS = 4
TIME_INTERVAL_WEEKS = 5
TIME_INTERVAL_MONTHS = 6
TIME_INTERVAL_QUARTERS = 7
TIME_INTERVAL_YEARS = 8

DEFAULT:

TIME_INTERVAL_UNDEFINED

SYNTAX:

void setMajorGridTickInterval(int newValue);
int getMajorGridTickInterval();

MinorGridTickInterval

This property controls minor grids and ticks on interval (seconds to years) boundries in a chart that uses a time scale axis.

DATA TYPE:

integer

RANGE:

0...8

TIME_INTERVAL_UNDEFINED = 0
TIME_INTERVAL_SECONDS = 1
TIME_INTERVAL_MINUTES = 2
TIME_INTERVAL_HOURS = 3
TIME_INTERVAL_DAYS = 4
TIME_INTERVAL_WEEKS = 5
TIME_INTERVAL_MONTHS = 6
TIME_INTERVAL_QUARTERS = 7
TIME_INTERVAL_YEARS = 8

DEFAULT:

TIME_INTERVAL_UNDEFINED

SYNTAX:

void setMinorGridTickInterval(int newValue);
int getMinorGridTickInterval();

Quarter1StartMonth

This property defines the first quarter start month in a time scale axis chart.

DATA TYPE:

integer

RANGE:

1...12

DEFAULT:

1 (January)

SYNTAX:

void setQuarter1StartMonth(int newValue);
int getQuarter1StartMonth();

EXAMPLE:

setQuarter1StartMonth(1);

setQuarter1StartMonth(9);

UseTimeScaleAxis

This property enables (true) / disables (false) use of the time scale axis. If this property is enabled (true), you must set the UseSampleData property to false and use the setData() methods to define the data to be charted. Additionally, the setLevelInterval() and setLevelTextFormat() methods must be used to define the number of time intervals and the format of data that is shown at each level.

DATA TYPE:

boolean

RANGE:

true / false; true = Use time scale axis, false = Use normal axis

DEFAULT:

false

SYNTAX:

void setUseTimeScaleAxis(boolean newValue);
boolean getUseTimeScaleAxis();

EXAMPLE:

restoreDefaults();
setUseTimeScaleAxis(true);
clearDataLabels();
clearGroupLabels();
clearSeriesLabels();
setLegendDisplay(false);
setDepthRadius(0);
clearDataStorage();
setUseSampleData(false);
setData(0,0,12,28,2003);
setData(0,1,10.0);
setData(0,2,12,29,2003);
setData(0,3,20.0);
setData(0,4,12,30,2003);
setData(0,5,30.0);
setData(0,6,12,31,2003);
setData(0,7,25.0);
setData(0,8,01,01,2004);
setData(0,9,20.0);
setData(0,10,01,2,2004);
setData(0,11,25.0);
setData(0,12,01,3,2004);
setData(0,13,22.0);
setData(0,14,01,4,2004);
setData(0,15,23.0);
setData(1,0,12,28,2003);
setData(1,1,12.0);
setData(1,2,12,29,2003);
setData(1,3,12.0);
setData(1,4,12,30,2003);
setData(1,5,21.0);
setData(1,6,12,31,2003);
setData(1,7,15.0);
setData(1,8,01,01,2004);
setData(1,9,23.0);
setData(1,10,1,2,2004);
setData(1,11,25.0);
setData(1,12,1,3,2004);
setData(1,13,25.0);
setData(1,14,1,4,2004);
setStartDate(12,28,2003);
setEndDate(1,4,2004);
setDataRangeToExtent();
setGraphType(17);
setSeriesType(getSeries(0), 1);
setSeriesType(getSeries(1), 2);
setUseTimeScaleAxis(true);
setLevelInterval(0,4);
setLevelInterval(1,6);
setLevelInterval(2,8);
setLevelTextFormat(0,0);
setLevelTextFormat(1,2);
setLevelTextFormat(2,2);

NOTE:

This property can only be used with clustered bar, stacked bar, line, and scatter charts.

ALSO SEE:

setLevelInterval(), setLevelTextFormat(), setStartDate(), setEndDate(), "Data in Time Scale Axis Charts"