<doc>
  <legacy_id>1359</legacy_id>
  <name>roundRect</name>
  <type>keyword</type>
  <syntax>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
    <synonym>round rect</synonym>
    <synonym>round rectangle</synonym>
    <synonym>roundRectangle</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> or <keyword tag="graphic">graphic</keyword> is shaped like a rectangle with rounded corners. It also designates the <glossary tag="paint tool">paint tool</glossary> used to draw rounded-corner rectangles.</summary>
  <examples>
    <example>set the style of graphic "Outline" to roundRect</example>
    <example>choose round rectangle tool</example>
  </examples>
  <description>
    <p>Use the <b>roundRect</b> <glossary tag="keyword">keyword</glossary> to paint a rounded rectangle or square with the <property tag="penColor">penColor</property> or to change a <keyword tag="graphic">graphic</keyword> or <keyword tag="button">button</keyword> to a rounded rectangle shape.</p><p/><p><b>Comments:</b></p><p>When using the Round Rectangle tool, the cursor is a crosshairs shape (over stack windows) or an arrow (anywhere else). This tool is used to draw a rounded 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 Round 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="button">button</keyword> or <keyword tag="graphic">graphic</keyword> to<code> roundRect </code>makes the graphic into a rounded rectangle. Rounded rectangle <glossary tag="graphic">graphics</glossary>, unlike painted rounded rectangles, can be changed and reshaped: use the <b>height</b> and <b>width</b> <property tag="properties">properties</property> to change the shape and size.</p><p/><p><code/><img src="202653"/> <b>Important!</b><code/> You can use the synonyms--<code>round rect</code>,<code> round rectangle</code>, and<code> roundRectangle</code>--to choose the round rectangle paint tool, but not to set a <glossary tag="graphic">graphic's</glossary> <property tag="style">style</property> <glossary tag="property">property</glossary>.</p>
  </description>
</doc>