<doc>
  <legacy_id>3522</legacy_id>
  <name>openControl</name>
  <type>message</type>
  <syntax>
    <example>openControl</example>
  </syntax>
  <library></library>
  <objects>
    <group/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Writing LiveCode</category>
  </classification>
  <references>
    <message tag="preOpenControl">preOpenControl Message</message>
    <message tag="openCard">openCard Message</message>
    <message tag="preOpenBackground">preOpenBackground Message</message>
    <message tag="closeControl">closeControl Message</message>
  </references>
  <history>
    <introduced version="3.5">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Sent to a <object tag="group">group</object> right after you go to the card that contains it or to a <property tag="backgroundBehavior">background group</property> right after going from a card where it was is not placed on to one where it is.</summary>
  <examples>
    <example>on openControl</p><p>  startProgressAnimation</p><p>  databaseQuery</p><p>end openControl</example>
  </examples>
  <description>
    <p>Handle the <b>openControl</b> message to change a group's objects or perform other updates, when a card with the group on is visited.</p><p/><p><b>Comments:</b></p><p>For groups with their <property tag="backgroundBehavior">backgroundBehavior property</property> set to true, the <b>openControl</b> message is sent immediately after the <message tag="openBackground">openBackground message</message> is sent to the card being opened. For non-background groups, it is sent after the <message tag="openCard">openCard message</message>.</p><p/><p>For nested groups, the <b>openControl</b> message is sent to the parent group first, if it is passed or not handled by the parent group, then it passes though each child group in reverse layer order (i.e from highest to lowest).</p>
  </description>
</doc>