<doc>
  <legacy_id>2175</legacy_id>
  <name>palette</name>
  <type>command</type>
  <syntax>
    <example>palette <i>stack</i></example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Windows &amp; Dialog Boxes</category>
  </classification>
  <references>
    <command tag="modeless">modeless Command</command>
    <command tag="drawer">drawer Command</command>
    <property tag="activatePalettes">activatePalettes Property</property>
    <property tag="hidePalettes">hidePalettes Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Opens a <object tag="stack">stack</object> in a <glossary tag="palette">palette window</glossary>.</summary>
  <examples>
    <example>palette stack "Tools"</example>
    <example>palette the defaultStack</example>
  </examples>
  <description>
    <p>Use the <b>palette</b> <glossary tag="command">command</glossary> to display a <object tag="stack">stack</object> in a <glossary tag="palette">palette window</glossary>.</p><p/><p><b>Parameters:</b></p><p>The <i>stack</i> is any <href tag="reference/object_reference.rev">stack reference</href>.</p><p/><p><b>Comments:</b></p><p>Use palette windows to display tools or information about main windows.</p><p/><p>A palette window behaves like an ordinary window, except that its appearance is different, with a narrower title bar. If the <b>raisePalettes</b> <glossary tag="property">property</glossary> is set to true, any <glossary tag="palette">palettes</glossary> float in their own <property tag="layer">layer</property>, above all ordinary windows. <glossary tag="palette">Palettes</glossary> cannot be resized or edited.  To edit a <command tag="palette">palette</command>, use the <command tag="topLevel">topLevel</command> <glossary tag="command">command</glossary> to display it in an <glossary tag="editable window">editable window</glossary>.</p><p/><p>The <b>palette</b> <glossary tag="command">command</glossary> closes the <object tag="stack">stack</object> and reopens it as a <command tag="palette">palette</command>, so <message tag="closeStack">closeStack</message> and <message tag="openStack">openStack</message>, <message tag="closeCard">closeCard</message> and <message tag="openCard">openCard</message>, and (if applicable) <message tag="closeBackground">closeBackground</message> and <message tag="openBackground">openBackground</message> <glossary tag="message">messages</glossary> are sent to the <glossary tag="current card">current card</glossary> as a result of <glossary tag="execute">executing</glossary> this <glossary tag="command">command</glossary>. Use the <command tag="lock messages">lock messages</command> <glossary tag="command">command</glossary> before <glossary tag="execute">executing</glossary> <b>palette</b> if you want to prevent the close <glossary tag="message">messages</glossary> from being sent; the open <glossary tag="message">messages</glossary> are sent regardless of the setting of the <property tag="lockMessages">lockMessages</property> <glossary tag="property">property</glossary>.</p><p/><p>If the stack is already displayed as a palette, the <b>palette</b> <glossary tag="command">command</glossary> does not close and reopen it.</p><p/><p>The Browse tool is always used in palette windows, regardless of the current setting of the <b>tool</b> <glossary tag="property">property</glossary>.</p>
  </description>
</doc>