CDPieSetSectorLabel < Main

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

_This subroutine sets the label for the "current" or specified sector specs._

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

This routine sets the label text into a newly initialized text spec and links the text spec with the specified pie sector spec. Any previously set text attributes for the pie sector label are reset. This will override any label you may have set using [[CDPieSectorAddNext][.PIE SECT ADD NEXT]].

If &lt;sector_no&gt; is received and is not blank, the Label is stored in the specified sector. If &lt;sector_no&gt; is not received or is blank, the label is stored in the current 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.

The pie sector spec updated becomes the "current" pie sector spec and label becomes the "current" label spec.

---++ Comments:

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

<br />%COMMENT%

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