<doc>

<legacy_id>2012</legacy_id>

<name>frontScripts</name>

<type>function</type>

<syntax>

<example>the frontScripts</example>

<example>frontScripts()</example>

</syntax>

<synonyms>

</synonyms>

<summary><glossary tag="return">Returns</glossary> a list of <glossary tag="object">objects</glossary> that have been inserted into the <glossary tag="message path">message path</glossary> before the target <glossary tag="object">object</glossary>.</summary>

<examples>

<example>the frontScripts</example>

<example>if myID is not among the lines of the frontScripts then insertMe</example>

</examples>

<history>

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

<deprecated version=""></deprecated>

<removed version=""></removed>

<changed version=""></changed>

<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>Objects &amp; Messages</category>

<category>Standalone Applications</category>

</classification>

<references>

<command tag="remove script">remove script command</command>

</references>

<description>

<overview>Use the <b>frontScripts</b> function to find out which scripts receive messages and function calls before the target object.</overview>

<parameters>

</parameters>

<value>The <b>frontScripts</b> function returns a list of the long ID property of all objects that have been inserted into the front, one ID per line.</value>

<comments>A script inserted into the front with the <command tag="insert script">insert script</command> command receives messages before all objects in the message path.<p></p><p>This includes messages sent with the <command tag="send">send</command> command, so if you send a message to an object, the objects in the <b>frontScripts</b> receive that message before the target object does. If the scripts in the <b>frontScripts</b> do not use the <control_st tag="pass">pass</control_st> control structure to pass on the message to the next object, the target object never receives the message.</p><p></p><p>If more than one object is in the <b>frontScripts</b>, their order in the message path is the same as their order in the list. For example, the first object in the <b>frontScripts</b> receives messages before the second object. This order is the reverse of the order in which the objects were added with the <command tag="insert script">insert script</command> command.</p></comments>

</description>

</doc>