CDPieSectorAddNext < Main

Tags: view all tags
---+ .PIE SECT ADD NEXT

_This subroutine is called to create a new pic chart sector spec._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;sector_data_point&gt;        FIELD            SHARE? N
      PASS         &lt;sector_label&gt;             FIELD            SHARE? N
      PASS         &lt;text_spec_name&gt;           FIELD            SHARE? N
      GOSUB    0CD .PIE SECT ADD NEXT
      *        Check for error
      IF       0CD .PIE SECT ADD NEXT         NE</pre>
---++ Description:

<div id="_mcePaste">This subroutine creates a new pic chart sector spec for the "current" chart, and optionally adds a label. This is an easy way to add data and labels to your pie chart simutaneously. If you want to change the attributes of the sector just added (ie, 3D Depth, Color, etc), do that before adding the next sector. Any changes you made to the attributes of the newly added sector will be inherited by the next sector you add, unless you pass 'initialize' as the &lt;text_spec_name&gt; parameter (see below).</div>

The &lt;sector_data_point&gt; parameter is optional. If a &lt;sector_data_point&gt; is received, then the corresponding data point record is created or updated.

The &lt;sector_label&gt; parameter is optional. If a &lt;sector_label&gt; is received, that label will be used on your pie chart and a text spec will be created for the label. You can use the .TEXT routines to change the attributes of the text associated with this data point. Remember that any changes you make will be inherited by the next sector you add, unless you pass 'initialize' as the &lt;text_spec_name&gt; parameter

The &lt;text_spec_name&gt; parameter is optional. If a &lt;text_spec_name&gt; is received, that text spec will be used to create the label. You can also pass "current" to use the "current" text spec, or "initialize" to reset the text spec back to defaults before adding the sector. The "initialize" value is useful if you have changed the attributes on the previous sector and you want the next one(s) to use default values. If you do not pass a &lt;text_spec_name&gt;, the previous text spec will be used.

The newly added data point is set to be the "current" data point, the newly added sector is set to be the "current" sector spec, and if a &lt;text_spec_name&gt; is provided, it becomes the "current" text spec.
---++ Comments:

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

<br />

I ran into the problem that &#60;sector_dat_point&#62;  in my application (because of system parameters) the decimal notation is  a comma instead of a dot. If you give this parameter a value with a comma in it, you get two sectors instead of one. After I set the value in an alpha field and changed the comma to a dot, the problem was over and I got a nice &#34;one-sector&#34;. I believe this is reported to ASI.

-- %BUBBLESIG{WimJongejan - 2015-03-06}%
%COMMENT%

-- Main.JeanNeron - 2011-10-03
Topic revision: r5 - 2015-03-06 - WimJongejan