home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / devtools / toolkt21 / os2help / wpkhlp.hlp (.txt) < prev   
Encoding:
OS/2 Help File  |  1993-02-15  |  5.9 KB  |  174 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Help for Workplace Class List ΓòÉΓòÉΓòÉ
  3.  
  4. The Workplace Class List is used to create a workplace object class, and an 
  5. instance of a workplace object class. 
  6.  
  7. The primary window contains a list of the workplace object classes currently 
  8. registered in the OS/2 Workplace Shell.  Using this window, you can: 
  9.  
  10. o Create an instance of a workplace object class 
  11. o Replace a workplace object class 
  12. o Unreplace a workplace object class 
  13. o Add a workplace object class 
  14. o Delete a workplace object class 
  15.  
  16.  
  17. ΓòÉΓòÉΓòÉ 1.1. Create an instance of a Workplace Object Class ΓòÉΓòÉΓòÉ
  18.  
  19. To create an instance of a workplace object class: 
  20.  
  21.  1. Select the class from the list on the workplace object class window. 
  22.  2. Display the pop-up menu by single-clicking mouse button 2. 
  23.  3. Select the Create Instance choice. 
  24.  4. Fill-in the following input fields: 
  25.  
  26.    Object Title 
  27.      is the text string you assign the object.  The text string becomes the 
  28.      object title and appears under the object when the object is displayed on 
  29.      the Workplace Shell.  When the object is in an opened state, the text 
  30.      string appears in the title bar of the window. 
  31.  
  32.    Class of new object 
  33.      is the name of the class of which the object you selected is a member. 
  34.  
  35.    Parameters 
  36.      is a series of keyname=value pairs (separated by semicolons) that change 
  37.      the behavior of the object.  Each object class defines the keynames and 
  38.      parameters it expects to see. All parameters have safe defaults, so it is 
  39.      never required to pass parameters to an object. 
  40.  
  41.    Location 
  42.      is one of the following values: 
  43.  
  44.       o A real name specified by a fully qualified path name. For example: 
  45.  
  46.                  C:\OS2\DLL
  47.  
  48.       o A logical name specified by a predefined symbol.  For example, 
  49.  
  50.          <WP_NOWHERE>                            The hidden folder. 
  51.          <WP_DESKTOP>                            The OS/2 desktop (Workplace). 
  52.          <WP_OS2SYS>                             The OS/2 system folder. 
  53.          <WP_TEMPS>                              The template folder. 
  54.          <WP_CONFIG>                             The system setup folder. 
  55.          <WP_START>                              The startup folder. 
  56.          <WP_INFO>                               The information folder. 
  57.          <WP_DRIVES>                             The drives folder. 
  58.  
  59. Related Information: 
  60.  
  61. o Replace a workplace object class 
  62. o Unreplace a workplace object class 
  63. o Add a workplace object class 
  64. o Delete a workplace object class 
  65.  
  66.  
  67. ΓòÉΓòÉΓòÉ 1.2. Replace a Workplace Object Class ΓòÉΓòÉΓòÉ
  68.  
  69. To replace an existing registered class: 
  70.  
  71.  1. Select the class from the list on the workplace object class window. 
  72.  2. Display the pop-up menu by single-clicking mouse button 2. 
  73.  3. Select the Replace choice.  Note that only classes that have already been 
  74.     registered are valid. 
  75.  4. Fill-in the following input fields: 
  76.  
  77.    Original class 
  78.      is the name of the object class being replaced in the Workplace. 
  79.  
  80.    Replacement class 
  81.      if the name of the object class replacing the original class. 
  82.  
  83. Note:  The replacement class must be a descendant of the original class. 
  84.        Replacing an object class is useful for modifying the behavior of 
  85.        objects which are instances of the original class but are not aware of 
  86.        the replacement class. 
  87.  
  88. Related Information: 
  89.  
  90. o Create an instance of a workplace object class 
  91. o Unreplace a workplace object class 
  92. o Add a workplace object class 
  93. o Delete a workplace object class 
  94.  
  95.  
  96. ΓòÉΓòÉΓòÉ 1.3. Unreplace a Workplace Object Class ΓòÉΓòÉΓòÉ
  97.  
  98. To return a replaced class to its original class: 
  99.  
  100.  1. Select the replaced class from the list on the workplace object class 
  101.     window. 
  102.  2. Display the pop-up menu by single-clicking mouse button 2. 
  103.  3. Select the Unreplace choice.  Note that only classes that have already been 
  104.     replaced are valid. 
  105.  4. Fill-in the following input fields: 
  106.  
  107.    Original class 
  108.      is the name of the replaced object class being returned to its original 
  109.      object class in the Workplace. 
  110.  
  111.    Replacement class 
  112.      if the name of the replaced object class being returned to its original 
  113.      object class. 
  114.  
  115. Related Information: 
  116.  
  117. o Create an instance of a workplace object class 
  118. o Replace a workplace object class 
  119. o Add a workplace object class 
  120. o Delete a workplace object class 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 1.4. Adding a Workplace Object Class ΓòÉΓòÉΓòÉ
  124.  
  125. To add a class to the Workplace Shell: 
  126.  
  127.  1. Display the pop-up menu by single-clicking mouse button 2. 
  128.  2. Select the Add Class choice. 
  129.  3. Fill-in the following input fields: 
  130.  
  131.    New class name 
  132.      is the name of object class you want to add to the Workplace. Type the 
  133.      class name exactly as it is built, case sensitive. 
  134.  
  135.    Library module 
  136.      is the name of the dynamic link library (DLL) that holds the object 
  137.      definition.  Type the library name with complete file specification 
  138.      information. 
  139.  
  140.      Note:  The DLL must be created by the IBM System Object Model. 
  141.  
  142.  
  143. Related Information: 
  144.  
  145. o Create an instance of a workplace object class 
  146. o Replace a workplace object class 
  147. o Unreplace a workplace object class 
  148. o Delete a workplace object class 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ 1.5. Delete a Workplace Object Class ΓòÉΓòÉΓòÉ
  152.  
  153. To delete a class from the Workplace Shell: 
  154.  
  155.  1. Select the class you want to delete from the list on the workplace object 
  156.     class window. 
  157.  2. Display the pop-up menu by single-clicking mouse button 2. 
  158.  3. Select the Delete a Class choice. 
  159.  4. Fill-in the following input fields: 
  160.  
  161.    Name of class 
  162.      is the name of the class you want to delete from the Workplace. 
  163.  
  164.     Note:  You cannot delete system predefined classes.  For example, WPObject 
  165.            or WPClass. 
  166.  
  167.  
  168. Related Information: 
  169.  
  170. o Create an instance of a workplace object class 
  171. o Replace a workplace object class 
  172. o Unreplace a workplace object class 
  173. o Add a workplace object class 
  174.