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