═══ 1. Help for Workplace Class List ═══

The Workplace Class List is used to create a workplace object class, and an 
instance of a workplace object class. 

The primary window contains a list of the workplace object classes currently 
registered in the OS/2 Workplace Shell.  Using this window, you can: 

     Create an instance of a workplace object class 
     Replace a workplace object class 
     Unreplace a workplace object class 
     Add a workplace object class 
     Delete a workplace object class 


═══ 1.1. Create an instance of a Workplace Object Class ═══

To create an instance of a workplace object class: 

   1. Select the class from the list on the workplace object class window. 
   2. Display the pop-up menu by single-clicking mouse button 2. 
   3. Select the Create Instance choice. 
   4. Fill-in the following input fields: 
      Object Title 
             is the text string you assign the object.  The text string becomes 
             the object title and appears under the object when the object is 
             displayed on the Workplace Shell.  When the object is in an opened 
             state, the text string appears in the title bar of the window. 

      Class of new object 
             is the name of the class of which the object you selected is a 
             member. 

      Parameters 
             is a series of keyname=value pairs (separated by semicolons) that 
             change the behavior of the object.  Each object class defines the 
             keynames and parameters it expects to see. All parameters have 
             safe defaults, so it is never required to pass parameters to an 
             object. 

      Location 
             is one of the following values: 

                 A real name specified by a fully qualified path name. For 
                  example: 

                                     C:\OS2\DLL

                 A logical name specified by a predefined symbol.  For 
                  example, 

                  <WP_NOWHERE>                                 The hidden 
                                                               folder. 
                  <WP_DESKTOP>                                 The OS/2 desktop 
                                                               (Workplace). 
                  <WP_OS2SYS>                                  The OS/2 system 
                                                               folder. 
                  <WP_TEMPS>                                   The template 
                                                               folder. 
                  <WP_CONFIG>                                  The system setup 
                                                               folder. 
                  <WP_START>                                   The startup 
                                                               folder. 
                  <WP_INFO>                                    The information 
                                                               folder. 
                  <WP_DRIVES>                                  The drives 
                                                               folder. 

 Related Information: 

     Replace a workplace object class 
     Unreplace a workplace object class 
     Add a workplace object class 
     Delete a workplace object class 


═══ 1.2. Replace a Workplace Object Class ═══

To replace an existing registered class: 

   1. Select the class from the list on the workplace object class window. 
   2. Display the pop-up menu by single-clicking mouse button 2. 
   3. Select the Replace choice.  Note that only classes that have already been 
      registered are valid. 
   4. Fill-in the following input fields: 
      Original class 
             is the name of the object class being replaced in the Workplace. 

      Replacement class 
             if the name of the object class replacing the original class. 

 Note:  The replacement class must be a descendant of the original class. 
        Replacing an object class is useful for modifying the behavior of 
        objects which are instances of the original class but are not aware of 
        the replacement class. 

 Related Information: 

     Create an instance of a workplace object class 
     Unreplace a workplace object class 
     Add a workplace object class 
     Delete a workplace object class 


═══ 1.3. Unreplace a Workplace Object Class ═══

To return a replaced class to its original class: 

   1. Select the replaced class from the list on the workplace object class 
      window. 
   2. Display the pop-up menu by single-clicking mouse button 2. 
   3. Select the Unreplace choice.  Note that only classes that have already 
      been replaced are valid. 
   4. Fill-in the following input fields: 
      Original class 
             is the name of the replaced object class being returned to its 
             original object class in the Workplace. 

      Replacement class 
             if the name of the replaced object class being returned to its 
             original object class. 

 Related Information: 

     Create an instance of a workplace object class 
     Replace a workplace object class 
     Add a workplace object class 
     Delete a workplace object class 


═══ 1.4. Adding a Workplace Object Class ═══

To add a class to the Workplace Shell: 

   1. Display the pop-up menu by single-clicking mouse button 2. 
   2. Select the Add Class choice. 
   3. Fill-in the following input fields: 
      New class name 
             is the name of object class you want to add to the Workplace. Type 
             the class name exactly as it is built, case sensitive. 

      Library module 
             is the name of the dynamic link library (DLL) that holds the 
             object definition.  Type the library name with complete file 
             specification information. 

             Note:  The DLL must be created by the IBM System Object Model. 
 Related Information: 

     Create an instance of a workplace object class 
     Replace a workplace object class 
     Unreplace a workplace object class 
     Delete a workplace object class 


═══ 1.5. Delete a Workplace Object Class ═══

To delete a class from the Workplace Shell: 

   1. Select the class you want to delete from the list on the workplace object 
      class window. 
   2. Display the pop-up menu by single-clicking mouse button 2. 
   3. Select the Delete a Class choice. 
   4. Fill-in the following input fields: 
      Name of class 
             is the name of the class you want to delete from the Workplace. 

      Note:  You cannot delete system predefined classes.  For example, 
             WPObject or WPClass. 
 Related Information: 

     Create an instance of a workplace object class 
     Replace a workplace object class 
     Unreplace a workplace object class 
     Add a workplace object class