<doc>
  <legacy_id>3494</legacy_id>
  <name>printerSettings</name>
  <type>property</type>
  <syntax>
    <example>set the printerSettings to <i>string</i></example>
    <example>get the printerSettings</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="1.0">Added.</introduced>
    <changed version="2.9"></changed>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
    <printing/>
  </security>
  <summary>Returns device-specific settings for the current printer.</summary>
  <examples>
    <example>set the printerSettings to the cSavedPrintSettings of me</example>
    <example>put the printerSettings into url ("binfile:" &amp; printerSettingsFile())</example>
  </examples>
  <description>
    <p>Use the <b>printerSettings</b> to get or set the device-specific settings for the current printer. </p><p/><p><b>Value:</b></p><p>The <b>printerSettings</b> is an opaque binary string containing the settings and printer name.</p><p/><p><b>Comments:</b></p><p>Setting the <b>printerSettings</b> will attempt to choose and configure the current printer with the supplied settings. If the printer is found but the settings are not valid, the printer will be chosen and configured with the default values. If the printer is not found, the result will be set to "unknown printer".</p><p/><p>Setting the <b>printerSettings</b> to empty will reset the printer to the system default and all printer settings to the default for the printer.</p><p/><p>To have an effect, this property must be set before calling <command tag="open printing">open printing</command>.</p>
  </description>
</doc>