<doc>
  <legacy_id>1332</legacy_id>
  <name>rectangle</name>
  <type>keyword</type>
  <syntax>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
    <synonym>rect</synonym>
  </synonyms>
  <classification>
    <category>Appearance &amp; Positioning</category>
    <category>Developing with LiveCode</category>
  </classification>
  <references>
    <command tag="choose">choose Command</command>
    <property tag="brushColor">brushColor Property</property>
    <property tag="brushPattern">brushPattern Property</property>
  </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>Specifies that a <keyword tag="button">button</keyword>, <keyword tag="field">field</keyword>, or <keyword tag="graphic">graphic</keyword> <glossary tag="object">object</glossary> is shaped like a rectangle. It also designates the <glossary tag="paint tool">paint tool</glossary> used to draw rectangles and squares.</summary>
  <examples>
    <example>choose rectangle tool</example>
    <example>set the style of button ID 3 to rectangle</example>
  </examples>
  <description>
    <p>Use the <b>rectangle</b> <glossary tag="keyword">keyword</glossary> to paint a rectangle or square with the <property tag="penColor">penColor</property> or to change a <keyword tag="graphic">graphic</keyword> to a rectangle shape.</p><p/><p><b>Comments:</b></p><p>When using the Rectangle tool, the cursor is a crosshairs shape (over stack windows) or an arrow (anywhere else). This tool is used to draw a rectangle or square in the <b>penColor</b>, filled with the <property tag="brushColor">brushColor</property> (or <property tag="brushPattern">brushPattern</property>).</p><p/><p>If you try to paint with the Rectangle 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<code> rectangle </code>makes the graphic into a rectangle. Rectangle <glossary tag="graphic">graphics</glossary>, unlike painted rectangles, can be changed and reshaped: use the <property tag="height">height</property> and <property tag="width">width</property> <property tag="properties">properties</property> to change the shape and size of the rectangle.</p><p/><p>Setting the <b>style</b> of a <keyword tag="field">field</keyword> or <keyword tag="button">button</keyword> to<code> rectangle </code><a/>makes it a rectangle shape.</p>
  </description>
</doc>