<doc>
  <legacy_id>1080</legacy_id>
  <name>line</name>
  <type>keyword</type>
  <syntax>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Developing with LiveCode</category>
    <category>Appearance &amp; Positioning</category>
    <category>Text and Data Processing</category>
  </classification>
  <references>
    <command tag="choose">choose Command</command>
    <keyword tag="word">word Keyword</keyword>
    <keyword tag="character">character Keyword</keyword>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Designates a return-<glossary tag="delimit">delimited</glossary> <keyword tag="string">string</keyword> as part of a <glossary tag="chunk expression">chunk expression</glossary>. It also designates the <glossary tag="paint tool">paint tool</glossary> used to draw line shapes and specifies, through the <property tag="style">style</property> <glossary tag="property">property</glossary>, that a <keyword tag="graphic">graphic</keyword> is a line.</summary>
  <examples>
    <example>get line 3 of the stacks</example>
    <example>choose line tool</example>
    <example>set the style of graphic "Divider" to "line"</example>
  </examples>
  <description>
    <p>Use the <b>line</b> <glossary tag="keyword">keyword</glossary> to paint a curved line with the <property tag="penColor">penColor</property>, to draw a line shape, or to refer to a specific <keyword tag="line">line</keyword> or <keyword tag="lines">lines</keyword> in a <glossary tag="container">container</glossary>.</p><p/><p><b>Comments:</b></p><p>When using the Line tool, the cursor is a crosshairs shape (over stack windows) or an arrow (anywhere else). This tool is used to draw a straight line in the <b>penColor</b>.</p><p/><p>If you try to paint with the Line tool on a card that has no images, an image the size of the card is created to hold the painting. If the current card already has one or more images, painting outside the image has no effect.</p><p/><p>Setting the <b>style</b> of a <keyword tag="graphic">graphic</keyword> to "line" makes the <keyword tag="graphic">graphic</keyword> into a curved line. Line <glossary tag="graphic">graphics</glossary>, unlike painted lines, can be changed and reshaped: use the <property tag="points">points</property> <glossary tag="property">property</glossary> to change the line's angle and position.</p><p/><p><b>Note:</b> To avoid script errors, enclose the word "line" in <glossary tag="double quote">double quotes</glossary> when you use it to indicate a <glossary tag="graphic">graphic's</glossary> <property tag="style">style</property>. This prevents <glossary tag="LiveCode">LiveCode</glossary> from getting confused about whether you mean the line style, or the contents of a line in a <glossary tag="container">container</glossary>.</p><p/><p>By default, a line is delimited by <b>return</b> (ASCII 10). However, you can set the <property tag="lineDelimiter">lineDelimiter</property> <glossary tag="property">property</glossary> to any <keyword tag="character">character</keyword> in order to directly address <glossary tag="chunk">chunks</glossary> <glossary tag="delimit">delimited</glossary> by that character.</p><p/><p>A line is a string of characters delimited by a single <b>return</b> character (or a single one of the <property tag="lineDelimiter">lineDelimiter</property> <keyword tag="character">character</keyword>). A single <keyword tag="line">line</keyword> can contain multiple <keyword tag="characters">characters</keyword>, multiple <keyword tag="words">words</keyword>, and multiple <keyword tag="items">items</keyword>.</p><p/><p><b>Note:</b> In LiveCode, if the last character of a string is return, this is ignored by the <b>line</b> keyword. For example the last line of the following string is "Line 3" :</p><p/><p>   Line 1</p><p>   Line 2</p><p>   Line 3</p><p>  &lt;empty Line&gt;</p>
  </description>
</doc>