<doc>
  <legacy_id>2250</legacy_id>
  <name>dashes</name>
  <type>property</type>
  <syntax>
    <example>set the dashes [of <i>graphic</i>] to <i>pixelsOn</i>[,<i>pixelsOff</i>]</example>
  </syntax>
  <library></library>
  <objects>
    <graphic/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <property tag="roundEnds">roundEnds Property</property>
    <property tag="relativePoints">relativePoints Property</property>
    <property tag="foregroundPattern">foregroundPattern Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
    <changed version="3.0"></changed>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies the appearance of dashed lines in <glossary tag="graphic">graphics</glossary> and paint <glossary tag="image">images</glossary>.</summary>
  <examples>
    <example>set the dashes to 10,2 <i>-- 10-pixel dashes separated by 2 pixels</i></example>
    <example>set the dashes of graphic "Connector" to 1,2,5,2 <i>-- "dit-dot" dashes</i></example>
    <example>set the dashes of graphic 10 to empty <i>-- makes a solid line</i></example>
  </examples>
  <description>
    <p>Use the <b>dashes</b> <glossary tag="property">property</glossary> to change the <glossary tag="appearance">appearance</glossary> of lines.</p><p/><p><b>Value:</b></p><p>A list of numbers which spcecifies a sequence of pixel lengths that alternately represent space and dash lengths. </p><p/><p>By default, the <b>dashes</b> <glossary tag="property">property</glossary> of a newly created <keyword tag="graphic">graphic</keyword> is set to empty.</p><p/><p><b>Comments:</b></p><p>The odd-numbered items in the <b>dashes</b> <glossary tag="property">property</glossary> represent the number of <property tag="pixels">pixels</property> in a dash, and the even-numbered <keyword tag="items">items</keyword> represent the number of <property tag="pixels">pixels</property> in the blank space after the dash. The list is repeated for the length of the line.   An odd number of pixel lengths will cause the dash and space pixel lengths to alternate between repeats.  For example, if the <b>dashes</b> is set to 20,10,5 the line will contain the following: 20 pixel dash, 10 pixel space, 5 pixel dash, 20 pixel space, 10 pixel dash, 5 pixel space etc.</p><p/><p>If the <b>dashes</b> <glossary tag="property">property</glossary> contains a single <keyword tag="integer">integer</keyword> the dashes and spaces will both be given this pixel value.  If the <b>dashes </b>property is empty, the line will be solid.</p><p/><p>The global setting of the <b>dashes</b> <glossary tag="property">property</glossary> <glossary tag="control">controls</glossary> the <glossary tag="appearance">appearance</glossary> of lines drawn with the <glossary tag="paint tool">paint tools</glossary> in the same way. Once a paint line is drawn however, its <glossary tag="appearance">appearance</glossary> cannot be changed by changing the <command tag="global">global</command> <b>dashes</b> <glossary tag="property">property</glossary>.</p>
  </description>
</doc>