CDPieSetSectorPosition < Main

Tags: view all tags
---+ .PIE SET SECT POSITION

_This subroutine sets the position (Normal or Exploded) of the "current" or specified sector specs._

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

This subroutine sets the postion of the sector for the "current" or specified sector(s) to either Normal or Exploded

If &lt;sector_pos&gt; is not received or if the value received is blank, then the position of the sector spec is set to Normal. Valid values are: normal or explode/exploded.

<div id="_mcePaste">If &lt;beg_sect_no&gt; is "ALL" or "0" and &lt;end_sect_no&gt; is not received or is blank, then the position applies to all pie sectors.</div>

If &lt;beg_sect_no&gt; and &lt;end_sect_no&gt; are both received and are both numeric integers, then the position applies to the range of pie sectors from &lt;beg_sect_no&gt; thru &lt;end_sect_no&gt; and is stored in the corresponding pie sector specs.

If &lt;beg_sect_no&gt; is received and is a numeric integer and &lt;end_sect_no&gt; is not received or is blank, then the position applies only to the &lt;beg_sect_no&gt; pie sector.

If &lt;beg_sect_no&gt; and &lt;end_sect_no&gt; are both not received or are blank, then the position applies to the "current" pie sector and is stored in the "current" pie sector spec.

Any pie sector specs that are referenced but which do not exist are automatically created and initialized so that the position can be stored.

You can use [[CDPieSetSectorExplosionDistance][.PIE SET SECT EXP DIST]] to control the distances between the exploded sectors.

The last pie sector spec updated becomes the "current" pie sector spec.

---++ Comments:

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

<br />%COMMENT%

-- Main.JeanNeron - 2011-10-04
Topic revision: r3 - 2012-02-24 - JeanNeron