.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    0CD .CHART INITIALIZE
      *        Check for chart initiailization error
      IF       0CD .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> es el nombre 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 a chart with no name is initialized. If a chart with no name has been previously initialized, then the previously initialized 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 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.

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