<doc>
  <legacy_id>1322</legacy_id>
  <name>socketClosed</name>
  <type>message</type>
  <syntax>
    <example>socketClosed <i>socketID</i></example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
    <card/>
    <group/>
    <field/>
    <button/>
    <graphic/>
    <scrollbar/>
    <player/>
    <image/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Networks &amp; Communication</category>
  </classification>
  <references>
    <message tag="socketTimeout">socketTimeout Message</message>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Sent when the remote system closes a <glossary tag="socket">socket</glossary>.</summary>
  <examples>
    <example>on socketClosed theID <code><i>-- close a progress window for the socket</i></code></p><p>  set the itemDelimiter to "|" <code><i>-- get just the assigned name</i></code></p><p>  if there is a window (last item of theID)</p><p>  then close stack (last item of theID)</p><p>end socketClosed</example>
  </examples>
  <description>
    <p>Handle the <b>socketClosed</b> <keyword tag="message box">message</keyword> to perform cleanup after the remote system closes a <glossary tag="socket">socket</glossary>.</p><p/><p><b>Parameters:</b></p><p>The <i>socketID</i> is the identifier (set when you opened the <glossary tag="socket">socket</glossary>) of the <glossary tag="socket">socket</glossary> that's just been closed.</p><p/><p>The socket identifier starts with the IP address of the host the socket is connected to, and may optionally include a port number (separated from the IP address by a colon). If there is more than one socket connected to that host and port, you can specify which socket by appending the connection name or number that was assigned when the socket was opened, separated from the <glossary tag="port">port</glossary> number by a vertical bar (<code>|</code>).</p><p/><p><b>Comments:</b></p><p>The <b>socketClosed</b> <keyword tag="message box">message</keyword> is sent to the <glossary tag="object">object</glossary> that opened the <glossary tag="socket">socket</glossary>.</p><p/><p>If the socket closed due to an error, the <b>socketError</b> <keyword tag="message box">message</keyword> is sent instead of <b>socketClosed</b>.</p>
  </description>
</doc>