<doc>
  <legacy_id>3084</legacy_id>
  <name>printerOutput</name>
  <type>property</type>
  <syntax>
    <example>set the printerOutput to {device | preview | fileSpec}</example>
    <example>get the printerOutput</example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Printing</category>
  </classification>
  <references>
    <command tag="answer printer">answer printer Command</command>
  </references>
  <history>
    <introduced version="2.9">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
    <printing/>
  </security>
  <summary>Reports what the destination of a print job should be.</summary>
  <examples>
    <example>set the itemDelimiter to ":"</p><p>if item 1 of the printerOutput is "file" then</p><p>  set the hilite of button "Print To File" of group "Printer Settings" of me to true</p><p>end </p><p/><p>set the printerOutput to "device"</example>
  </examples>
  <description>
    <p>Use the <b>printerOutput</b> property to determine or change the destination of a print job.</p><p/><p><b>Value:</b></p><p>The <b>printerOutput</b> can be one of the following values.</p><p/><p> - device: output to the physical printer</p><p/><p> - file:&lt;filename&gt; : output to the given file. The format of the file depends on the platform:</p><p>  + Windows Vista uses XPS format.</p><p>  + UNIX uses PostScript format.</p><p>  + Mac OS X uses PDF format.</p><p>  + Older Windows versions use a system-specific format.</p><p/><p> - preview: output to print preview (only supported on Mac OS X).</p><p/><p> - system: output in a system-specific mode. This setting is read-only, and can occur if you configure an output in the answer printer dialog that LiveCode does not recognise (e.g. WorkFlow output options on Mac OS X 10.4 and above).</p><p/><p>The default value depends on the printer driver.</p><p/><p><b>Comments:</b></p><p>Setting the <b>printerOutput</b> to an invalid value will result in a script execution error.</p><p/><p>To have an effect, this property must be set before calling <command tag="open printing">open printing</command>.</p>
  </description>
</doc>