This documentation was styled with a demo skin from the Premium Pack 4 add-on for Help & Manual. The contents of the skin are encrypted and not configurable. You can only publish HM projects with this skin. You cannot edit it or change it.
This version is copyright and may only be used for local testing purposes. It may not be distributed.
Please purchase the full version of the Premium Pack to get the configurable skins and remove this notice. The package will also include the Toolbox configuration utility for Premium Pack skins.
Description
Draw a line in the currently selected canvas target
Syntax
n = Canvas_Line( [STEP] [(x1, y1)], [STEP] (x2, y2) [, rgbColor] )
Returns
Number
Parameters
Name |
Type |
Optional |
Meaning |
x1 |
Number |
Yes |
The upper left corner of the box |
y1 |
Number |
Yes |
The upper left corner of the box |
x2 |
Number |
No |
The lower right corner of the box. |
y2 |
Number |
No |
The lower right corner of the box. |
rgbColor |
Number |
Yes |
RGB color of the box edge. If omitted (or -1), the edge color defaults to the current foreground color for the selected canvas window. |
Remarks
If the first STEP option is included, the x1 and y1 starting coordinates are relative to the last point referenced (POS).
If the second STEP option is included, the x2 and y2 ending coordinates are relative to the starting coordinates.
Restrictions
In this function it is mandatory to use () exactly as indicated by the above syntax. This is due to the optional starting x, y position and many possibilities in which this function can be used.
Without using mentioned syntax it would be impossible to determine correct requested behave.
See also
Examples