<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.)</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>