<doc>

<legacy_id>2031</legacy_id>

<name>close</name>

<type>command</type>

<syntax>

<example>close <i>stack</i></example>

</syntax>

<synonyms>

</synonyms>

<summary>Closes a <glossary tag="stack window">stack window</glossary>.</summary>

<examples>

<example>close stack "Zoom Window"</example>

<example>close this stack</example>

</examples>

<history>

<introduced version="1.0">Added.</introduced>

<deprecated version=""></deprecated>

<removed version=""></removed>

<experimental version=""></experimental>

<nonexperimental version=""></nonexperimental>

</history>

<objects>

</objects>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<classification>

<category>Windows &amp; Dialog Boxes</category>

</classification>

<references>

<command tag="close file">close file Command</command>

<command tag="close printing">close printing Command</command>

<command tag="revCloseVideoGrabber">revCloseVideoGrabber Command</command>

<property tag="destroyStack">destroyStack Property</property>

<message tag="closeStackRequest">closeStackRequest Message</message>

</references>

<description>Use the <b>close</b> <glossary tag="command">command</glossary> to close a <object tag="stack">stack</object> without user intervention.<p></p><p><b>Parameters:</b></p><p>The <i>stack</i> is any open <object tag="stack">stack</object>.</p><p></p><p><b>Comments:</b></p><p>The <b>close</b> <glossary tag="command">command</glossary> closes the <glossary tag="stack window">stack window</glossary> immediately, but it does not necessarily remove the <object tag="stack">stack</object> from memory. A <object tag="stack">stack</object> that is closed but in memory still takes up space in RAM and its <glossary tag="object">objects</glossary> are still accessible to <glossary tag="script">scripts</glossary>.</p><p></p><p>If the stack's <b>destroyStack</b> <glossary tag="property">property</glossary> is set to false, or there are other <function tag="stacks">stacks</function> in the same file that are still open, closing the <object tag="stack">stack</object> does not purge the stack from memory.</p><p></p><p>If the handler that closes the stack is in the script of the stack (or in the script of an object in the stack) and the stack's <b>destroyStack</b> <glossary tag="property">property</glossary> is true, the <glossary tag="stack window">stack window</glossary> is closed immediately, but the stack is not removed from memory until after the <glossary tag="handler">handler</glossary> completes.</p></description>

</doc>