<doc>
  <legacy_id>2083</legacy_id>
  <name>startup</name>
  <type>message</type>
  <syntax>
    <example>startup <i>mode</i></example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Windows  Dialog Boxes</category>
  </classification>
  <references>
    <message tag="resume">resume Message</message>
    <message tag="openBackground">openBackground Message</message>
    <message tag="u3eject">u3eject Message</message>
    <message tag="relaunch">relaunch Message</message>
  </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>Sent to the first <object tag="stack">stack</object> opened when the <glossary tag="application">application</glossary> starts up.</summary>
  <examples>
    <example>on startup pMode</p><p>global gRunningFromU3Drive</p><p>switch pMode</p><p> case "u3launch"</p><p> put true into gRunningFromU3Drive</p><p> break</p><p> case empty</p><p> put false into gRunningFromU3Drive</p><p> break</p><p>end switch</p><p>end startup</example>
  </examples>
  <description>
    <p>Handle the <b>startup</b> <keyword tag="message box">message</keyword> if you want to do initialization or other tasks when the <glossary tag="application">application</glossary> starts up. </p><p/><p>If you are developing your application to work from a U3 compliant drive, you can use the <i>mode</i> argument to respond to U3 actions.</p><p><i>mode</i> is one of</p><p>        *  u3install : sent when the u3p file is being installed onto the U3 drive </p><p>        *  u3configure : sent when the application is first run from a U3 drive </p><p>        *  u3launch : sent when the application is started from a U3 drive (after installation and configuration) </p><p>        *  u3cleanup : sent when the LaunchPad requests the application cleans up  </p><p>        *  u3uninstall : sent when the application is being removed from the U3 drive.</p><p/><p><b>Comments:</b></p><p>The <b>startup</b> <keyword tag="message box">message</keyword> is sent only when the <glossary tag="application">application</glossary> starts up, not when a <object tag="stack">stack</object> is opened when the <glossary tag="application">application</glossary> is already running.</p><p/><p>If the application is opened with multiple stacks, the <b>startup</b> message is sent to the first <object tag="stack">stack</object> opened.</p><p/><p>You will only get the U3 actions u3install, u3configure, u3cleanup and u3uninstall if the corresponding tick boxes have been checked in the advanced U3 settings of the Standalone Settings.</p>
  </description>
</doc>