<doc>
  <legacy_id>1960</legacy_id>
  <name>modeless</name>
  <type>command</type>
  <syntax>
    <example>modeless <i>stack</i></example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Windows &amp; Dialog Boxes</category>
  </classification>
  <references>
    <property tag="cantSelect">cantSelect Property</property>
    <property tag="dialogData">dialogData Property</property>
    <command tag="go">go Command</command>
    <command tag="modal">modal Command</command>
    <property tag="mode">mode Property</property>
    <command tag="palette">palette Command</command>
    <command tag="sheet">sheet Command</command>
    <property tag="style">style Property</property>
    <command tag="topLevel">topLevel Command</command>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
  </classes>
  <security>
  </security>
  <summary>Opens a <object tag="stack">stack</object> in a <glossary tag="modeless dialog box">modeless dialog</glossary> window.</summary>
  <examples>
    <example>modeless stack "Hello World"</example>
    <example>modeless the defaultStack</example>
  </examples>
  <description>
    <p>Use the <b>modeless</b> <glossary tag="command">command</glossary> to display a <object tag="stack">stack</object> as a custom <glossary tag="modeless dialog box">modeless dialog box</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>A modeless dialog box behaves like an ordinary window, except that it cannot be edited. Use modeless dialog boxes to ask the user for information.</p><p/><p>To edit a modeless dialog box, use the <b>topLevel</b> <glossary tag="command">command</glossary> to display it in an <glossary tag="editable window">editable window</glossary>.</p><p/><p>The <b>modeless</b> <glossary tag="command">command</glossary> closes the <object tag="stack">stack</object> and reopens it as a <glossary tag="modeless dialog box">modeless dialog box</glossary>, 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>modeless</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 modeless dialog box, the <b>modeless</b> <glossary tag="command">command</glossary> does not close and reopen it.</p><p/><p>The Browse tool is used in modeless dialog boxes, regardless of the current setting of the <b>tool</b> <glossary tag="property">property</glossary>.</p>
  </description>
</doc>