<doc>

<legacy_id>1670</legacy_id>

<name>hide</name>

<type>command</type>

<syntax>

<example>hide <i>object</i> [with visual [effect] <i>effectName</i> [<i>speed</i>] [to <i>finalImage</i>]]</example>

</syntax>

<library></library>

<objects>

</objects>

<synonyms>

</synonyms>

<classification>

<category>Appearance &amp; Positioning</category>

</classification>

<references>

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

<command tag="answer effect">answer effect Command</command>

<command tag="hide menubar">hide menubar Command</command>

<keyword tag="black">black Keyword</keyword>

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

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

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

</references>

<history>

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

<changed version="1.1"></changed>

</history>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<summary>Makes an <glossary tag="object">object</glossary> invisible.</summary>

<examples>

<example>hide button 14</example>

<example>hide field "New" with visual effect dissolve</example>

<example>hide this stack with visual dissolve fast to black</example>

</examples>

<description>

<p>Use the <b>hide</b> <glossary tag="command">command</glossary> to hide <glossary tag="object">objects</glossary> temporarily or permanently.</p><p/><p><b>Parameters:</b></p><p>The <i>object</i> is any open <object tag="stack">stack</object>, or any <keyword tag="control">control</keyword> in an open <object tag="stack">stack</object>.</p><p/><p>The <i>effectName</i>, <i>speed</i>, and <i>finalImage</i> are described in the <command tag="visual effect">visual effect</command> command. These three <glossary tag="parameter">parameters</glossary> operate the same way as they do in the <command tag="visual effect">visual effect</command> command.</p><p/><p><b>Comments:</b></p><p>Hiding an object sets its <b>visible</b> <glossary tag="property">property</glossary> to false. The <glossary tag="object">object</glossary> itself is still in the <object tag="stack">stack</object> and can be restored with the <command tag="show">show</command> <glossary tag="command">command</glossary>. You can also set the <property tag="showInvisibles">showInvisibles</property> <glossary tag="property">property</glossary> to true to override the <property tag="visible">visible</property> <glossary tag="property">property</glossary> and show all <glossary tag="object">objects</glossary>.</p><p/><p>Hiding a stack hides its window, but does not close the stack. If the stack is being displayed as a drawer, hiding it slides it back into its parent stack.</p><p/><p>You can hide a card without causing a script error, but doing so has no effect.</p><p/><p>Hiding a group hides all the controls in the group.</p><p/><p><b>Changes:</b></p><p>The ability to use QuickTime special effects was introduced in version 1.1. In previous versions, only the built-in visual effects listed under the <b>visual effect</b> <glossary tag="command">command</glossary> were available.</p>

</description>

</doc>