
          Using InterDesk's Graphical Shell's Autostartup Facility


                                Introduction

  InterDesk's Graphical Shell provides an autostartup service.  This permits 
  applications which are open when QNXWin shuts down to  register  with  the 
  Shell.  The next time the Shell is loaded (presumably the next time QNXWin 
  is  started  up), it will execute the command specified by the registering 
  application.  This would typically be used to  start  up  the  application 
  again.
  
  The  InterDesk  Graphical  Shell MUST be loaded for this to work properly.  
  It should be included in the "screen.cfg" file as a program to be run when 
  QNXWin starts up.

  Note that if the Graphical Shell is loaded with the "-A"  parameter,  then 
  no autostartup commands will be executed.


                                Legal Issues

  This library, source code, and documentation are all Copyright (C) 1996 by 
  Scott C. Moonen.  All Rights Reserved.

  You may use this library, code, and  documentation  free  of  charge.   No
  royalty  fee  whatsoever  is  charged  for  use of this library, code, and
  documentation, whether by individuals, governments, or corporate entities.

  You may  freely  distribute  this  code,  but  only  under  the  following
  conditions:  If  you  redistribute this code, library, or documentation to
  others, you must distribute it in  full,  including  ALL  files  in  their
  original form, completely unmodified.


                                 Disclaimer

  Anyone who uses this library, code, and documentation does so at their own 
  risk, and bears ALL responsibility as to the outcome.  Scott  Moonen  will 
  not be held liable for any errors in this library, code, or documentation; 
  or for any results arising from their use.

  The  information  in  this  code  and  documentation  is subject to change 
  without notice.  Scott Moonen reserves the right to update or change  such 
  information at his discretion and without the consent of or any obligation 
  to any users.


                                Library Use
  
  See the document "DragDrop.txt" for more specific information on using the 
  InterDesk Graphical Shell interface library.
  
  
                                AutoStartup
  
  When QNXWin begins its shutdown procedure, an  application  may  call  the 
  function  IDAutoStart()  to register itself to be started up the next time
  the Shell is loaded.  This  function  contains  a  single  parameter:  the
  command  to  be  executed  on  start-up.   Its  return value is a standard
  InterDesk library error code.

  As an example:

    switch(Event(&event))               /* Get event id.                    */
    {
      case QW_TERMINATED:               /* Windows shut down.               */
        IDAutoStart("/windows/apps/MyApp/hello_world -q -t4");
        goto Quit;

      ...

    }

  The next time the Shell is  loaded,  it  will  then  execute  the  command 
  "/windows/apps/MyApp/hello_world -q -t4".
