<doc>
  <legacy_id>3089</legacy_id>
  <name>printRanges</name>
  <type>property</type>
  <syntax>
    <example>set the printRanges to <i>rangesList</i></example>
    <example>get the printRanges</example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Printing</category>
  </classification>
  <references>
    <command tag="answer printer">answer printer Command</command>
    <property tag="printPageNumber">printPageNumber Property</property>
  </references>
  <history>
    <introduced version="2.9">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
    <printing/>
  </security>
  <summary>Reports the pages that should be printed in the next print job.</summary>
  <examples>
    <example>set the printRanges to the text of field "Ranges" of group "Printer Settings"</example>
    <example>set the printRanges to "1-5,10,12-20"</example>
  </examples>
  <description>
    <p>Use the <b>printRanges</b> property to specify ranges of pages to be printed. </p><p/><p><b>Value:</b></p><p>The <b>printRanges</b> property is one of the following values.</p><p>  - "selection": print the current selection (Windows only).</p><p>  - "current": print the current page (Windows only).</p><p>  - "all": print all pages</p><p>  - a comma-separated list of ranges or individual page numbers.</p><p/><p><b>Comments:</b></p><p>If the <b>printRanges</b> is set to a list of ranges, LiveCode will automatically skip pages not in the range. Otherwise it is up to the application to print the appropriate pages.</p><p/><p>If an application wishes to handle the skipping of pages, it can do so by setting the <b>printRanges</b> property to "all" before starting the printing loop.</p><p/><p><b>Note:</b> LiveCode automatically handles coalescing overlapping ranges, e.g. 1-10,5-25,23 will result in the range being 1-25.</p><p/><p>To have an effect, this property must be set before calling <command tag="open printing">open printing</command>.</p><p/>
  </description>
</doc>