<doc>

<legacy_id>1471</legacy_id>

<name>answer effect</name>

<type>command</type>

<syntax>

<example>answer effect</example>

</syntax>

<library></library>

<objects>

</objects>

<synonyms>

</synonyms>

<classification>

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

<category>Images &amp; Multimedia</category>

</classification>

<references>

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

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

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

<function tag="QTEffects">QTEffects Function</function>

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

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

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

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

</references>

<history>

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

</history>

<platforms>

<mac/>

<windows/>

</platforms>

<classes>

<desktop/>

</classes>

<security>

</security>

<summary>Displays the <glossary tag="QuickTime">QuickTime</glossary> special effects <glossary tag="dialog box">dialog box</glossary>.</summary>

<examples>

<example>answer effect</example>

<example>if the altKey is down then answer effect</example>

</examples>

<description>

<p>Use the <b>answer effect</b> <glossary tag="command">command</glossary> to choose a visual effect, or to set up an effect with complex options for later use.</p><p/><p><b>Comments:</b></p><p>The <b>answer effect</b> <glossary tag="command">command</glossary> displays a <glossary tag="dialog box">dialog box</glossary> where the user can select a visual effect and (for some effects) set parameters such as speed and direction. (This <glossary tag="dialog box">dialog box</glossary> is displayed by <glossary tag="QuickTime">QuickTime</glossary>, not by LiveCode. Thus make sure the <b>dontUseQT</b> property is set to false, to allow LiveCode work with QuickTime)</p><p/><p>An encoded description of the visual effect the user chooses is placed in the <b>it</b> <glossary tag="variable">variable</glossary>. You can either use the encoded description immediately, or store it (for example, in a <glossary tag="variable">variable</glossary> or in a <property tag="customProperties">custom property</property>) for later use. To display the effect, use the encoded description with the <command tag="visual effect">visual effect</command> <glossary tag="command">command</glossary>, with the <command tag="unlock screen">unlock screen</command> <glossary tag="command">command</glossary>, or with the<code> hide with visual effect </code>or<code> show with visual effect </code>form of the <b>hide</b> or <command tag="show">show</command> <glossary tag="command">command</glossary>.</p><p/><p>If the user cancels the dialog, the <b>it</b> <glossary tag="variable">variable</glossary> is set to empty, and the <function tag="result">result</function> <control_st tag="function">function</control_st> <glossary tag="return">returns</glossary> "Cancel".</p>

</description>

</doc>