<doc>
  <legacy_id>1306</legacy_id>
  <name>dialogData</name>
  <type>property</type>
  <syntax>
    <example>set the dialogData to <i>string</i></example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Windows &amp; Dialog Boxes</category>
  </classification>
  <references>
    <command tag="ask">ask Command</command>
    <command tag="modeless">modeless Command</command>
    <property tag="default">default Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies data to be <glossary tag="pass">passed</glossary> to a <glossary tag="dialog box">dialog box</glossary>.</summary>
  <examples>
    <example>set the dialogData to "OK"</example>
    <example>put last item of the dialogData into buttonReceived</example>
  </examples>
  <description>
    <p>Use the <b>dialogData</b> <glossary tag="property">property</glossary> to <control_st tag="pass">pass</control_st> data between a <glossary tag="dialog box">dialog box</glossary> and the <object tag="stack">stack</object> that opens the <glossary tag="dialog box">dialog box</glossary>.</p><p/><p><b>Value:</b></p><p>The <b>dialogData</b> is a <keyword tag="string">string</keyword>.</p><p/><p><b>Comments:</b></p><p>The <b>dialogData</b> can be used for any data you wish to place in it. For example, you can use it within a <glossary tag="modal dialog box">modal dialog</glossary> <object tag="stack">stack</object> to hold the name of the <keyword tag="button">button</keyword> the user clicked, the state of other options that are set in the <glossary tag="dialog box">dialog box</glossary>, the contents of text <glossary tag="field">fields</glossary> the user filled in, and any other information. The <glossary tag="handler">handler</glossary> that showed the <glossary tag="dialog box">dialog box</glossary> can then use the information in the <b>dialogData</b>. The <glossary tag="caller">calling handler</glossary> can also place information--for example, <keyword tag="default">default</keyword> settings--into the <b>dialogData</b> <glossary tag="property">property</glossary>, and the <glossary tag="modal dialog box">modal dialog</glossary> <object tag="stack">stack</object> can use that information to set up the <glossary tag="dialog box">dialog box</glossary> when it opens.</p><p/><p>Since the <b>dialogData</b> <glossary tag="property">property</glossary> is <command tag="global">global</command> and can be set or accessed by any <object tag="stack">stack</object>, this method generally creates simpler code than the alternatives (such as using <command tag="global">global</command> <glossary tag="variable">variables</glossary>, or <glossary tag="pass">passing</glossary> <glossary tag="parameter">parameters</glossary> between <function tag="stacks">stacks</function>).</p><p/><p><img src="202651"/> <b>Tip:</b> The built-in "Answer Dialog" and "Ask Dialog" stacks, which are used by the <command tag="ask">ask</command> and <command tag="answer">answer</command> <glossary tag="command">commands</glossary>, use the <b>dialogData</b> <glossary tag="property">property</glossary> to <control_st tag="pass">pass</control_st> data between the <glossary tag="development environment">development environment</glossary> and the <glossary tag="dialog box">dialog box</glossary>. To see the <glossary tag="script">scripts</glossary> used for these <function tag="stacks">stacks</function>, enter one of the following <glossary tag="statement">statements</glossary> into the <keyword tag="message box">message box</keyword>:</p><p/><p>  edit the script of card 1 of stack "Answer Dialog"</p><p>  edit the script of card 1 of stack "Ask Dialog"</p>
  </description>
</doc>