CDChartInitialize < Main

<!-- WYSIWYG content - do not remove this comment, and never use this identical text in your topics-->
---+ .CHART INITIALIZE

_This subroutine is called to initialize or reinitialize a chart spec._

%TOC%
---++ Usage:
<verbatim>      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</verbatim>
---++ Description:

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

*&lt;chart_type&gt;* identifies the type of chart that is to be initialized. Passing this parameter is required. The valid values for *&lt;chart_type&gt;* are:

<blockquote>Angular Meter<br />Finance Chart<br />Linear Meter<br />Multi Chart<br />Pie Chart<br />Polar Chart<br />Pyramid Chart<br />Surface chart<br />XY Chart<br /></blockquote>

*&lt;chart_spec_name&gt;* es el nombre the name which uniquely identifies the chart spec which is to be initialized. The *&lt;chart_spec_name&gt;* 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 *&lt;chart_spec_name&gt;* 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 *&lt;chart_spec_name&gt;* 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 *&lt;chart_type&gt;* 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, 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._

%COMMENT%

-- Main.SteveFrizzell - 2010-02-15
This topic: Main > WebHome > APPX510Features > CDChartDirectorDesignerAPI > CDChartDirectorBaseChartRoutines > CDChartInitialize
Topic revision: r15 - 2013-02-20 - RayPelegrino