CDLineInitialize < Main

Tags: view all tags
---+ .LINE INITIALIZE

_This subroutine initializes a line on the "current" chart._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;line_spec_name&gt;           FIELD            SHARE? N
      PASS         &lt;start_x&gt;                  FIELD            SHARE? N
      PASS         &lt;start_y&gt;                  FIELD            SHARE? N
      PASS         &lt;end_x&gt;                    FIELD            SHARE? N
      PASS         &lt;end_y&gt;                    FIELD            SHARE? N
      GOSUB    0CD .LINE INITIALIZE
      *        Check for error
      IF       0CD .LINE INITIALIZE           NE

</pre>
---++ Description:

<div id="_mcePaste">This subroutine initializes (draws) a line on the "current" chart. If the named line exists, then initialization removes all the formatting from the specified line and everything is reset to defaults.</div>

&lt;line_spec_name&gt; is a required parameter and the subroutine will cancel if it is not received. If the &lt;line_spec_name&gt; is blank, an error will be returned.

&lt;line_spec_name&gt; can be any name you want to assign to this line object (Required).

&lt;start_x&gt; is the X co-ordinate of the starting point of the line. This is required, and must be in the range 1-99999.

&lt;start_y&gt; is the Y co-ordinate of the starting point of the line. This is required, and must be in the range 1-99999.

&lt;end_x&gt; is the X co-ordinate of the ending point of the line. This is required, and must be in the range 1-99999.

&lt;end_y&gt; is the Y co-ordinate of the ending point of the line. This is required, and must be in the range 1-99999.

All co-ordinates are in pixels. The origin (0,0) is the upper left corner of your chart.

The default width is one pixel, and the default color is black. You can change the width and color using [[CDLineSetW][.LINE SET W]] or [[CDLineSetClr][.LINE SET CLR]].

The newly initialized line object is set to be the "current" line object.
---++ Comments:

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

<br />%COMMENT%

-- Main.JeanNeron - 2012-02-17
Topic revision: r2 - 2012-02-19 - JeanNeron