home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD5.iso / workbench / datatypes / switchwindowal.lha / sw.wbexecclass.c.doc < prev    next >
Encoding:
Text File  |  1996-03-18  |  3.1 KB  |  107 lines
  1. TABLE OF CONTENTS
  2.  
  3. switchwindow/wbexecchildclass
  4. switchwindow/wbexecclass
  5. switchwindow/wbexecchildclass                   switchwindow/wbexecchildclass
  6.  
  7.    NAME
  8.        wbexecchildclass -- Invoke a programm like from workbench.
  9.  
  10.    FUNCTION
  11.        NOP
  12.  
  13.        Class:        wbexecchildclass
  14.        Superclass:   rootclass
  15.  
  16.    METHODS
  17.        OM_NEW -- create a new object. If the creating of the new process
  18.            fails, the object won't be created.
  19.  
  20.        OM_GET -- obtain the value of an attribute.
  21.  
  22.        OM_DISPOSE -- dispose object. If the project didn't finished yet,
  23.            wait for it.
  24.  
  25.    TAGS
  26.        ...
  27.  
  28.    NOTE
  29.        Because it's ILLEGAL to scan another process pathlist the
  30.        "default tool" path will be got from current process.
  31.  
  32.    BUGS
  33.        Does currently not scan paths when processing projecticon's default
  34.        tool.
  35.        This will be fixed.
  36.  
  37. switchwindow/wbexecclass                             switchwindow/wbexecclass
  38.  
  39.    NAME
  40.        wbexecclass -- Invoke a programm like from workbench.
  41.  
  42.    FUNCTION
  43.        Starts a program like from workbench.
  44.        This class creates for eatch OM_UPDATE running on a process a
  45.        wbexecchildclass object which starts the application.
  46.  
  47.        Class:        wbexecclass
  48.        Superclass:   rootclass
  49.  
  50.    METHODS
  51.        OM_NEW -- create a new object.
  52.  
  53.        OM_SET -- set an object's attribute.
  54.  
  55.        OM_GET -- obtain the value of an attribute.
  56.  
  57.        OM_UPDATE -- update an object's attribute and creates a
  58.            new wbexecchildclass object which starts the program when
  59.            any tags appears in (msg -> opu_AttrList).
  60.            Finished wbexecchildclass objects will be disposed.
  61.            NOTE that this one works for an OM_UPDATE running on a process.
  62.            OM_UPDATE running on a plane task are only allowed to update
  63.            attributes.
  64.  
  65.        OM_DISPOSE -- Wait for outstanding wbexecchilds. Then dispose itself.
  66.  
  67.    TAGS
  68.        WBEXECA_IconName (STRPTR) -- name of icon to process.
  69.            This may be a toolicon or a projecticon.
  70.            If a projecticon is given, it's default tool will be invoked.
  71.  
  72.            Applicability is (ISGU).
  73.  
  74.        WBEXECA_NumArgs (LONG) -- number of entries in
  75.            WBEXECA_ArgList array.
  76.  
  77.            Applicability is (ISU).
  78.  
  79.        WBEXECA_ArgList (struct WBArg *) -- array of (struct WBArg)
  80.           entries.
  81.  
  82.            Applicability is (ISU).
  83.  
  84.        WBEXECA_UserData (ULONG) -- like GA_UserData
  85.  
  86.            Applicability is (ISGU).
  87.  
  88.        NP_Priority (long) -- process priority.
  89.            Defaults to 0L.
  90.  
  91.            Applicability is (ISGU).
  92.  
  93.        NP_StackSize (long) -- default stacksize for all new processes.
  94.            Defaults to 4096L.
  95.  
  96.            Applicability is (ISGU).
  97.  
  98.    NOTE
  99.        OM_UPDATE will only work with processes, not with tasks.
  100.        This will be a problem when gadgets want to invoke programs in this
  101.        way.
  102.        A direct link from input.device task driven gadget will only be useful
  103.        to update attributes.
  104.        The workaround is to set the target to ICTARGET_IDCMP and connect the
  105.        window to the wbexecclass object.
  106.  
  107.