CDPieSetDataset < Main

---+ .PIE SET DATASET

_This subroutine associates a dataset with the "current" pie chart._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;dataset_name&gt;             FIELD            SHARE? N
      GOSUB    0CD .PIE SET DATASET
      *        Check for error
      IF       0CD .PIE SET DATASET           NE
</pre>
---++ Description:

This associates the named dataset with the "current" pie chart.

When a Pie chart is initialized via [[CDChartInitialize][.CHART INITIALIZE]], a default dataset is initialized for you (unless you have already initialized a dataset separately, see [[CDOverviewDatasetDefinition][Datasets Overview]] for more information).

If you are working with multiple datasets, this routine allows you to link a particular dataset to the chart. That is the dataset that will be used when the chart is rendered.

If *&lt;dataset_name&gt;* is specified, it must refer to a previously initialized dataset or blank to refer to the default dataset for the chart. If you do not pass *&lt;dataset_name&gt;*, then whatever is the "current" dataset will be associated with the "current" chart.

After associating the dataset with the "current" chart, that dataset becomes the "current" dataset.
---++ Comments:

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

<br />%COMMENT%

-- Main.JeanNeron - 2011-09-29

This topic: Main > WebHome > APPX510Features > CDChartDirectorDesignerAPI > CDChartDirectorPieChartRoutines > CDPieSetDataset
Topic revision: r3 - 2012-02-24 - JeanNeron