CDPieSetLabelDistance < Main

Tags: view all tags
---+ .PIE SET LBL DISTANCE

_This subroutine sets the label layout for all pie sectors, a range of pie sectors, an individual pie sector, or the "current" pie sector._

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

This subroutine sets the label distance in pixels for all pie sectors, a range of pie sectors, an individual pie sector, or the "current" pie sector. The label distance is usually specified in conjunction with a label layout method via [[CDPieSetLabelLayoutMethod][.PIE SET LBL LAYOUT]]. If a label distance is specified and a label layout method is not specified, the Circular method is used.

If &lt;lbl_dist&gt; is not received or is blank, then the "current" pie sector will have it's label in the default position.

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

If &lt;beg_sect_no&gt; and &lt;end_sect_no&gt; are both received and are both numeric integers, then &lt;lbl_dist&gt; applies to the range
<div id="_mcePaste">of pie sectors from &lt;beg_sect_no&gt; thru &lt;end_sect_no&gt; and is stored in the corresponding pie sector specs.</div>

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 &lt;lbl_dist&gt;
<div id="_mcePaste">applies only to the &lt;beg_sect_no&gt; pie sector and is stored in the &lt;beg_sect_no&gt; pie sector spec.</div>

If &lt;beg_sect_no&gt; and &lt;end_sect_no&gt; are both not received or are blank, then &lt;lbl_dist&gt; 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 &lt;lbl_dist&gt; can be stored.

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

*NOTES:*

If you are using the 'Side' layout method, you cannot decrease the distance such that the label would be inside the "invisible rectangle". See the explanation of the 'Side' layout method in [[CDPieSetLabelLayoutMethod][.PIE SET LBL LAYOUT]].

---++ Comments:

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

<br />%COMMENT%

-- Main.JeanNeron - 2011-10-05
Topic revision: r5 - 2012-02-24 - JeanNeron