.CHART INITIALIZE

This subroutine is called to initialize or reinitialize a chart spec.

Usage:

      PASS         <chart_type>               FIELD            SHARE? N
      PASS         <chart_spec_name>          FIELD            SHARE? N
      GOSUB    CHT .CHART INITIALIZE
      *        Check for chart initiailization error
      IF       CHT .CHART INITIALIZE          NE

Description:

This subroutine must be the first subroutine called when defining a chart.

<chart_type> identifies the type of chart that is to be initialized. Passing this parameter is required. The valid values for <chart_type> are:

Angular Meter
Finance Chart
Linear Meter
Multi Chart
Pie Chart
Polar Chart
Pyramid Chart
Surface chart
XY Chart

<chart_spec_name> is the name which uniquely identifies the chart spec which is to be initialized. The <chart_spec_name> may be up to 30 characters in length and may contain the letters A-Z, the digits 0-9, and spaces. Passing this parameter is optional.

If the <chart_spec_name> parameter is not passed, then the "default" chart is initialized. If the "default" chart has been previously initialized, then the previously initialized "default" chart is reinitialized clearing all previously set values.

If the <chart_spec_name> parameter is passed, then a chart with the specified name is initialized. If a chart with the specified name has been previously initialized, then the previously initialized chart is reinitialized clearing all previously set values.

The newly initialized chart spec become the "current" chart.

If <chart_type> is Pie Chart, then this subroutine will associate a dataset with the newly initialized Pie Chart as follows:

• If a "current" dataset exists,
  • then that dataset is associated with the Pie Chart;
  • otherwise, if the "default" dataset exists
    • then that dataset is associated with the Pie Chart;
    • otherwise, the "default" dataset is initialized and is associated with the Pie Chart.

When a dataset is associated with the newly initialized chart, then that dataset becomes the "current" dataset.

This subroutine sets a result value in the corresponding results Token field.

Comments:

Read what other users have said about this page or add your own comments.

-- SteveFrizzell - 2010-02-15