home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv4.zip / VACPP / IBMCPP / HELP / WPS3.INF (.txt) < prev    next >
OS/2 Help File  |  1995-03-14  |  284KB  |  10,089 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Presentation Manager Functions Related to the Workplace Shell ΓòÉΓòÉΓòÉ
  3.  
  4. This section contains an alphabetical list of the Presentation Manager (PM) 
  5. functions which are available to the application for using and controlling 
  6. Workplace Shell objects. 
  7.  
  8.  
  9. ΓòÉΓòÉΓòÉ 1.1. WinCopyObject ΓòÉΓòÉΓòÉ
  10.  
  11.  
  12. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject - Syntax ΓòÉΓòÉΓòÉ
  13.  
  14. /*******************************************/
  15. /* This function is specific to version 3, */
  16. /* or higher, of the OS/2 operating        */
  17. /* system.  This function copies an object */
  18. /* from its existing location to a         */
  19. /* specified new destination.              */
  20. /*******************************************/
  21.  
  22. #define INCL_WINWORKPLACE
  23. #include <os2.h>
  24.  
  25. HOBJECT    hObjectofObject;  /*  Handle of the Workplace Shell object being copied. */
  26. HOBJECT    hObjectofDest;    /*  Handle of the destination folder into which hObjectofObject is to be copied. */
  27. ULONG      ulFlags;          /*  Flags. */
  28. HOBJECT    rc;               /*  Handle of the newly created object. */
  29.  
  30. rc = WinCopyObject(hObjectofObject, hObjectofDest,
  31.        ulFlags);
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject Parameter - hObjectofObject ΓòÉΓòÉΓòÉ
  35.  
  36.  hObjectofObject (HOBJECT) - input 
  37.     Handle of the Workplace Shell object being copied. 
  38.  
  39.  
  40. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject Parameter - hObjectofDest ΓòÉΓòÉΓòÉ
  41.  
  42.  hObjectofDest (HOBJECT) - input 
  43.     Handle of the destination folder into which hObjectofObject is to be 
  44.     copied. 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject Parameter - ulFlags ΓòÉΓòÉΓòÉ
  48.  
  49.  ulFlags (ULONG) - input 
  50.     Flags. 
  51.  
  52.       COPY_FAILIFEXSTS 
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject Return Value - rc ΓòÉΓòÉΓòÉ
  56.  
  57.  rc (HOBJECT) - returns 
  58.     Handle of the newly created object. 
  59.  
  60.     A return value of NULLHANDLE indicates that either hObjectofDest is 
  61.     NULLHANDLE or an object with the same name as hObjectofObject exists in the 
  62.     destination folder. 
  63.  
  64.  
  65. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject - Parameters ΓòÉΓòÉΓòÉ
  66.  
  67.  hObjectofObject (HOBJECT) - input 
  68.     Handle of the Workplace Shell object being copied. 
  69.  
  70.  hObjectofDest (HOBJECT) - input 
  71.     Handle of the destination folder into which hObjectofObject is to be 
  72.     copied. 
  73.  
  74.  ulFlags (ULONG) - input 
  75.     Flags. 
  76.  
  77.       COPY_FAILIFEXSTS 
  78.  
  79.  rc (HOBJECT) - returns 
  80.     Handle of the newly created object. 
  81.  
  82.     A return value of NULLHANDLE indicates that either hObjectofDest is 
  83.     NULLHANDLE or an object with the same name as hObjectofObject exists in the 
  84.     destination folder. 
  85.  
  86.  
  87. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject - Remarks ΓòÉΓòÉΓòÉ
  88.  
  89. Using HOBJECTs for .INI files or files in which an application uses a 
  90. rename/save/delete sequence is not supported. Its REXX counterpart is 
  91. SysCopyObject. 
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject - Errors ΓòÉΓòÉΓòÉ
  95.  
  96. Possible returns from WinGetLastError 
  97.  
  98.  WPERR_INVALID_FLAGS (0x1719) 
  99.     An invalid flag was specified. 
  100.  
  101.  
  102. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject - Related Functions ΓòÉΓòÉΓòÉ
  103.  
  104.    o  WinCreateObject. 
  105.    o  WinDestroyObject 
  106.    o  WinMoveObject 
  107.    o  WinQueryObjectWindow 
  108.    o  WinSaveObject 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject - Example Code ΓòÉΓòÉΓòÉ
  112.  
  113. This example copies the drives object into the startup folder; the drives 
  114. folder will be opened at the startup of the system. 
  115.  
  116.  
  117. #define INCL_WINWORKPLACE
  118. #include "os2.h"
  119.  
  120. HOBJECT    hObjectofDest;
  121. HOBJECT    hObjectofObject;
  122. HOBJECT    hObjectofResult;
  123.  
  124. hObjectofObject = WinQueryObject("<WP_DRIVES>");
  125. if (hObjectofObject != NULL)
  126.   {
  127.     /* WinQueryObject of Drives was successful */
  128.  
  129.     hObjectofDest = WinQueryObject("<WP_START>");
  130.     if (hObjectofDest != NULL)
  131.     {
  132.  
  133.          /* WinQueryObject of Startup was successful */
  134.  
  135.          hObjectofResult = WinCopyObject(hObjectofObject, hObjectofDest,CO_FAILIFEXISTS);
  136.  
  137.         if (hObjectofResult != NULL)
  138.         {
  139.              /* Drives Object was successfully copied to the Startup Folder */
  140.         }
  141.         else
  142.         {
  143.              /* Copy failed */
  144.  
  145.         }
  146.  
  147.  
  148. ΓòÉΓòÉΓòÉ <hidden> WinCopyObject - Topics ΓòÉΓòÉΓòÉ
  149.  
  150. Select an item: 
  151.  
  152. Syntax
  153. Parameters
  154. Returns
  155. Errors
  156. Remarks
  157. Example Code
  158. Related Functions
  159. Glossary
  160.  
  161.  
  162. ΓòÉΓòÉΓòÉ 1.2. WinCreateObject ΓòÉΓòÉΓòÉ
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject - Syntax ΓòÉΓòÉΓòÉ
  166.  
  167. /*******************************************/
  168. /* This function creates an instance of    */
  169. /* object class pszClassName, with title   */
  170. /* pszTitle, and places the icon and title */
  171. /* in the location referred to by          */
  172. /* pszLocation.                            */
  173. /*******************************************/
  174.  
  175. #define INCL_WINWORKPLACE
  176. #include <os2.h>
  177.  
  178. PSZ        pszClassName;    /*  Pointer to class name. */
  179. PSZ        pszTitle;        /*  Pointer to initial title of object. */
  180. PSZ        pszSetupString;  /*  Pointer to setup string. */
  181. PSZ        pszLocation;     /*  Folder location. */
  182. ULONG      ulFlags;         /*  Creation flags. */
  183. HOBJECT    rc;              /*  Handle to the created object. */
  184.  
  185. rc = WinCreateObject(pszClassName, pszTitle,
  186.        pszSetupString, pszLocation, ulFlags);
  187.  
  188.  
  189. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject Parameter - pszClassName ΓòÉΓòÉΓòÉ
  190.  
  191.  pszClassName (PSZ) - input 
  192.     Pointer to class name. 
  193.  
  194.     A pointer to a zero-terminated string which contains the name of the class 
  195.     of which this object is a member. 
  196.  
  197.  
  198. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject Parameter - pszTitle ΓòÉΓòÉΓòÉ
  199.  
  200.  pszTitle (PSZ) - input 
  201.     Pointer to initial title of object. 
  202.  
  203.     A pointer to a zero-terminated string which contains the initial title of 
  204.     the object as it is to appear when displayed on the user interface 
  205.     underneath an icon or on the title bar of an open object. 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject Parameter - pszSetupString ΓòÉΓòÉΓòÉ
  209.  
  210.  pszSetupString (PSZ) - input 
  211.     Pointer to setup string. 
  212.  
  213.     See WPLaunchPad for a table of setup strings used to customize the Launch 
  214.     Pad. 
  215.  
  216.  
  217. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject Parameter - pszLocation ΓòÉΓòÉΓòÉ
  218.  
  219.  pszLocation (PSZ) - input 
  220.     Folder location. 
  221.  
  222.     This value can be in any of the following formats: 
  223.  
  224.    o  Predefined object ids of system folders. 
  225.  
  226.            "<WP_NOWHERE>"           The hidden folder. 
  227.            "<LOCATION_DESKTOP>"     The currently active desktop. 
  228.            "<WP_OS2SYS>"            The System folder. 
  229.            "<WP_TEMPS>"             The Templates folder. 
  230.            "<WP_CONFIG>"            The System Setup folder. 
  231.            "<WP_START>"             The Startup folder. 
  232.            "<WP_INFO>"              The Information folder. 
  233.            "<WP_DRIVES>"            The Drives folder. 
  234.  
  235.    o  Real name specified as a fully qualified path name. 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject Parameter - ulFlags ΓòÉΓòÉΓòÉ
  239.  
  240.  ulFlags (ULONG) - input 
  241.     Creation flags. 
  242.  
  243.     This parameter can have one of the following values: 
  244.  
  245.       CO_FAILIFEXISTS 
  246.          No object will be created if an object with the given object ID 
  247.          already exists. This is the default. 
  248.  
  249.       CO_REPLACEIFEXISTS 
  250.          If an object with the given ID already exists, the existing object 
  251.          should be replaced. 
  252.  
  253.       CO_UPDATEIFEXISTS 
  254.          If an object with the given ID already exists, the existing object 
  255.          should be updated with the new information. 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject Return Value - rc ΓòÉΓòÉΓòÉ
  259.  
  260.  rc (HOBJECT) - returns 
  261.     Handle to the created object. 
  262.  
  263.       NULLHANDLE 
  264.          Error occurred. 
  265.       Other 
  266.          A handle to the object created.  This handle is persistent and can be 
  267.          used for the WinSetObjectData and WinDestroyObject function calls. 
  268.  
  269.  
  270. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject - Parameters ΓòÉΓòÉΓòÉ
  271.  
  272.  pszClassName (PSZ) - input 
  273.     Pointer to class name. 
  274.  
  275.     A pointer to a zero-terminated string which contains the name of the class 
  276.     of which this object is a member. 
  277.  
  278.  pszTitle (PSZ) - input 
  279.     Pointer to initial title of object. 
  280.  
  281.     A pointer to a zero-terminated string which contains the initial title of 
  282.     the object as it is to appear when displayed on the user interface 
  283.     underneath an icon or on the title bar of an open object. 
  284.  
  285.  pszSetupString (PSZ) - input 
  286.     Pointer to setup string. 
  287.  
  288.     See WPLaunchPad for a table of setup strings used to customize the Launch 
  289.     Pad. 
  290.  
  291.  pszLocation (PSZ) - input 
  292.     Folder location. 
  293.  
  294.     This value can be in any of the following formats: 
  295.  
  296.    o  Predefined object ids of system folders. 
  297.  
  298.            "<WP_NOWHERE>"           The hidden folder. 
  299.            "<LOCATION_DESKTOP>"     The currently active desktop. 
  300.            "<WP_OS2SYS>"            The System folder. 
  301.            "<WP_TEMPS>"             The Templates folder. 
  302.            "<WP_CONFIG>"            The System Setup folder. 
  303.            "<WP_START>"             The Startup folder. 
  304.            "<WP_INFO>"              The Information folder. 
  305.            "<WP_DRIVES>"            The Drives folder. 
  306.  
  307.    o  Real name specified as a fully qualified path name. 
  308.  
  309.  ulFlags (ULONG) - input 
  310.     Creation flags. 
  311.  
  312.     This parameter can have one of the following values: 
  313.  
  314.       CO_FAILIFEXISTS 
  315.          No object will be created if an object with the given object ID 
  316.          already exists. This is the default. 
  317.  
  318.       CO_REPLACEIFEXISTS 
  319.          If an object with the given ID already exists, the existing object 
  320.          should be replaced. 
  321.  
  322.       CO_UPDATEIFEXISTS 
  323.          If an object with the given ID already exists, the existing object 
  324.          should be updated with the new information. 
  325.  
  326.  rc (HOBJECT) - returns 
  327.     Handle to the created object. 
  328.  
  329.       NULLHANDLE 
  330.          Error occurred. 
  331.       Other 
  332.          A handle to the object created.  This handle is persistent and can be 
  333.          used for the WinSetObjectData and WinDestroyObject function calls. 
  334.  
  335.  
  336. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject - Remarks ΓòÉΓòÉΓòÉ
  337.  
  338. The pszSetupString contains a series of "keyname=value" pairs, that change the 
  339. behavior of the object. "keynames" are separated by semicolons, and "values" 
  340. are separated by commas. 
  341.  
  342.  
  343. "key=value;key2=value1,value2;"
  344.  
  345. If you want a literal comma or a literal semicolon inside one of your fields 
  346. you must type the following: 
  347.  
  348.     ^,     A literal comma. 
  349.     ^;     A literal semicolon. 
  350.  
  351.  Each object class documents the keynames and the parameters it expects to see 
  352.  immediately following. See the following keyname-value pairs tables: 
  353.  
  354.    o  WPColorPalette 
  355.    o  WPDisk 
  356.    o  WPFolder 
  357.    o  WPFontPalette 
  358.    o  WPKeyboard 
  359.    o  WPLaunchPad 
  360.    o  WPPalette 
  361.    o  WPPrinter 
  362.    o  WPRPrinter 
  363.    o  WPProgram 
  364.    o  WPProgramFile 
  365.    o  WPSchemePalette 
  366.    o  WPShadow 
  367.    o  WPObject 
  368.  
  369.  Note that ALL parameters have safe defaults, so it is never necessary to pass 
  370.  unnecessary parameters to an object. 
  371.  
  372.  For more information about object classes, see the Workplace Shell Programming 
  373.  Guide. 
  374.  
  375.  Using HOBJECT for .INI files or files in which an application uses a 
  376.  rename/save/delete sequence is not supported. 
  377.  
  378.  
  379. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject - Related Functions ΓòÉΓòÉΓòÉ
  380.  
  381.    o  WinDeregisterObjectClass 
  382.    o  WinDestroyObject 
  383.    o  WinRegisterObjectClass 
  384.    o  WinReplaceObjectClass 
  385.    o  WinSetObjectData 
  386.  
  387.  
  388. ΓòÉΓòÉΓòÉ <hidden> WinCreateObject - Topics ΓòÉΓòÉΓòÉ
  389.  
  390. Select an item: 
  391.  
  392. Syntax
  393. Parameters
  394. Returns
  395. Remarks
  396. Related Functions
  397. Glossary
  398.  
  399.  
  400. ΓòÉΓòÉΓòÉ 1.3. WinCreateShadow ΓòÉΓòÉΓòÉ
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow - Syntax ΓòÉΓòÉΓòÉ
  404.  
  405. /*******************************************/
  406. /* This function is specific to version 3, */
  407. /* or higher, of the OS/2 operating        */
  408. /* system.  This function creates a shadow */
  409. /* of an object and places it in a         */
  410. /* specified location.                     */
  411. /*******************************************/
  412.  
  413. #define INCL_WINWORKPLACE
  414. #include <os2.h>
  415.  
  416. HOBJECT    hObjectofObject;  /*  Handle of the object from which the shadow is to be created. */
  417. HOBJECT    hObjectofDest;    /*  Handle of the folder into which hObjectofObject is to be placed. */
  418. ULONG      ulReserved;       /*  Reserved value. Should be NULL. */
  419. HOBJECT    rc;               /*  Handle of the newly created shadow object. */
  420.  
  421. rc = WinCreateShadow(hObjectofObject, hObjectofDest,
  422.        ulReserved);
  423.  
  424.  
  425. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow Parameter - hObjectofObject ΓòÉΓòÉΓòÉ
  426.  
  427.  hObjectofObject (HOBJECT) - input 
  428.     Handle of the object from which the shadow is to be created. 
  429.  
  430.  
  431. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow Parameter - hObjectofDest ΓòÉΓòÉΓòÉ
  432.  
  433.  hObjectofDest (HOBJECT) - input 
  434.     Handle of the folder into which hObjectofObject is to be placed. 
  435.  
  436.  
  437. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow Parameter - ulReserved ΓòÉΓòÉΓòÉ
  438.  
  439.  ulReserved (ULONG) - input 
  440.     Reserved value. Should be NULL. 
  441.  
  442.  
  443. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow Return Value - rc ΓòÉΓòÉΓòÉ
  444.  
  445.  rc (HOBJECT) - returns 
  446.     Handle of the newly created shadow object. 
  447.  
  448.     A return value of NULLHANDLE indicates that either hObjectofDest is 
  449.     NULLHANDLE or an object with the same name as hObjectofObject exists in the 
  450.     destination folder. 
  451.  
  452.  
  453. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow - Parameters ΓòÉΓòÉΓòÉ
  454.  
  455.  hObjectofObject (HOBJECT) - input 
  456.     Handle of the object from which the shadow is to be created. 
  457.  
  458.  hObjectofDest (HOBJECT) - input 
  459.     Handle of the folder into which hObjectofObject is to be placed. 
  460.  
  461.  ulReserved (ULONG) - input 
  462.     Reserved value. Should be NULL. 
  463.  
  464.  rc (HOBJECT) - returns 
  465.     Handle of the newly created shadow object. 
  466.  
  467.     A return value of NULLHANDLE indicates that either hObjectofDest is 
  468.     NULLHANDLE or an object with the same name as hObjectofObject exists in the 
  469.     destination folder. 
  470.  
  471.  
  472. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow - Remarks ΓòÉΓòÉΓòÉ
  473.  
  474. Using HOBJECT for .INI files or files in which an application uses a 
  475. rename/save/delete sequence is not supported. Its REXX counterpart is 
  476. SysCreateShadowObject. 
  477.  
  478.  
  479. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow - Related Functions ΓòÉΓòÉΓòÉ
  480.  
  481.    o  WinCreateObject 
  482.    o  WinDestroyObject 
  483.    o  WinMoveObject 
  484.    o  WinQueryObjectWindow 
  485.    o  WinSaveObject 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ <hidden> WinCreateShadow - Topics ΓòÉΓòÉΓòÉ
  489.  
  490. Select an item: 
  491.  
  492. Syntax
  493. Parameters
  494. Returns
  495. Remarks
  496. Related Functions
  497. Glossary
  498.  
  499.  
  500. ΓòÉΓòÉΓòÉ 1.4. WinDeregisterObjectClass ΓòÉΓòÉΓòÉ
  501.  
  502.  
  503. ΓòÉΓòÉΓòÉ <hidden> WinDeregisterObjectClass - Syntax ΓòÉΓòÉΓòÉ
  504.  
  505. /*******************************************/
  506. /* This function deregisters (removes) a   */
  507. /* workplace object class.                 */
  508. /*******************************************/
  509.  
  510. #define INCL_WINWORKPLACE
  511. #include <os2.h>
  512.  
  513. PSZ     pszClassName;  /*  Pointer to class name. */
  514. BOOL    rc;            /*  Success indicator. */
  515.  
  516. rc = WinDeregisterObjectClass(pszClassName);
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ <hidden> WinDeregisterObjectClass Parameter - pszClassName ΓòÉΓòÉΓòÉ
  520.  
  521.  pszClassName (PSZ) - input 
  522.     Pointer to class name. 
  523.  
  524.     A pointer to a zero-terminated string which contains the name of the object 
  525.     class being removed from the workplace. 
  526.  
  527.  
  528. ΓòÉΓòÉΓòÉ <hidden> WinDeregisterObjectClass Return Value - rc ΓòÉΓòÉΓòÉ
  529.  
  530.  rc (BOOL) - returns 
  531.     Success indicator. 
  532.  
  533.       TRUE 
  534.          Successful completion 
  535.       FALSE 
  536.          Error occurred. 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ <hidden> WinDeregisterObjectClass - Parameters ΓòÉΓòÉΓòÉ
  540.  
  541.  pszClassName (PSZ) - input 
  542.     Pointer to class name. 
  543.  
  544.     A pointer to a zero-terminated string which contains the name of the object 
  545.     class being removed from the workplace. 
  546.  
  547.  rc (BOOL) - returns 
  548.     Success indicator. 
  549.  
  550.       TRUE 
  551.          Successful completion 
  552.       FALSE 
  553.          Error occurred. 
  554.  
  555.  
  556. ΓòÉΓòÉΓòÉ <hidden> WinDeregisterObjectClass - Remarks ΓòÉΓòÉΓòÉ
  557.  
  558. Workplace object classes are not deleted unless the application issues a 
  559. WinDeregisterObjectClass. Object classes will be automatically registered when 
  560. a dynamic-link library containing an object definition is added to the system. 
  561. The only advantage of deregistering an object class is to optimize the system 
  562. performance.  All registered classes are maintained in the OS2.INI and are 
  563. cached upon system initialization.  If the class is no longer needed, it should 
  564. be removed. 
  565.  
  566.  
  567. ΓòÉΓòÉΓòÉ <hidden> WinDeregisterObjectClass - Related Functions ΓòÉΓòÉΓòÉ
  568.  
  569.    o  WinCreateObject 
  570.    o  WinRegisterObjectClass 
  571.    o  WinReplaceObjectClass 
  572.  
  573.  
  574. ΓòÉΓòÉΓòÉ <hidden> WinDeregisterObjectClass - Topics ΓòÉΓòÉΓòÉ
  575.  
  576. Select an item: 
  577.  
  578. Syntax
  579. Parameters
  580. Returns
  581. Remarks
  582. Related Functions
  583. Glossary
  584.  
  585.  
  586. ΓòÉΓòÉΓòÉ 1.5. WinDestroyObject ΓòÉΓòÉΓòÉ
  587.  
  588.  
  589. ΓòÉΓòÉΓòÉ <hidden> WinDestroyObject - Syntax ΓòÉΓòÉΓòÉ
  590.  
  591. /*******************************************/
  592. /* This function is called to delete a     */
  593. /* workplace object.                       */
  594. /*******************************************/
  595.  
  596. #define INCL_WINWORKPLACE
  597. #include <os2.h>
  598.  
  599. HOBJECT    object;  /*  Handle to a workplace object. */
  600. BOOL       rc;      /*  Success indicator. */
  601.  
  602. rc = WinDestroyObject(object);
  603.  
  604.  
  605. ΓòÉΓòÉΓòÉ <hidden> WinDestroyObject Parameter - object ΓòÉΓòÉΓòÉ
  606.  
  607.  object (HOBJECT) - input 
  608.     Handle to a workplace object. 
  609.  
  610.  
  611. ΓòÉΓòÉΓòÉ <hidden> WinDestroyObject Return Value - rc ΓòÉΓòÉΓòÉ
  612.  
  613.  rc (BOOL) - returns 
  614.     Success indicator. 
  615.  
  616.       TRUE 
  617.          Successful completion. 
  618.       FALSE 
  619.          Error occurred. 
  620.  
  621.  
  622. ΓòÉΓòÉΓòÉ <hidden> WinDestroyObject - Parameters ΓòÉΓòÉΓòÉ
  623.  
  624.  object (HOBJECT) - input 
  625.     Handle to a workplace object. 
  626.  
  627.  rc (BOOL) - returns 
  628.     Success indicator. 
  629.  
  630.       TRUE 
  631.          Successful completion. 
  632.       FALSE 
  633.          Error occurred. 
  634.  
  635.  
  636. ΓòÉΓòÉΓòÉ <hidden> WinDestroyObject - Remarks ΓòÉΓòÉΓòÉ
  637.  
  638. The WinDestroyObject function will permanently remove an object that was 
  639. created with the WinCreateObject function. 
  640.  
  641. Using HOBJECT for .INI files or files in which an application uses a 
  642. rename/save/delete sequence is not supported. 
  643.  
  644.  
  645. ΓòÉΓòÉΓòÉ <hidden> WinDestroyObject - Related Functions ΓòÉΓòÉΓòÉ
  646.  
  647.    o  WinCreateObject 
  648.    o  WinSetObjectData 
  649.    o  WinDestroyObject 
  650.  
  651.  
  652. ΓòÉΓòÉΓòÉ <hidden> WinDestroyObject - Topics ΓòÉΓòÉΓòÉ
  653.  
  654. Select an item: 
  655.  
  656. Syntax
  657. Parameters
  658. Returns
  659. Remarks
  660. Related Functions
  661. Glossary
  662.  
  663.  
  664. ΓòÉΓòÉΓòÉ 1.6. WinEnumObjectClasses ΓòÉΓòÉΓòÉ
  665.  
  666.  
  667. ΓòÉΓòÉΓòÉ <hidden> WinEnumObjectClasses - Syntax ΓòÉΓòÉΓòÉ
  668.  
  669. /*******************************************/
  670. /* The WinEnumObjectClasses function will  */
  671. /* return a list of all workplace object   */
  672. /* classes that have been registered.      */
  673. /*******************************************/
  674.  
  675. #define INCL_WINWORKPLACE
  676. #include <os2.h>
  677.  
  678. POBJCLASS    pObjClass;  /*  Pointer to object class. */
  679. PULONG       pSize;      /*  Length of the pObjClass buffer in bytes. */
  680. BOOL         rc;         /*  Success indicator. */
  681.  
  682. rc = WinEnumObjectClasses(pObjClass, pSize);
  683.  
  684.  
  685. ΓòÉΓòÉΓòÉ <hidden> WinEnumObjectClasses Parameter - pObjClass ΓòÉΓòÉΓòÉ
  686.  
  687.  pObjClass (POBJCLASS) - input 
  688.     Pointer to object class. 
  689.  
  690.     A pointer to a buffer to be filled with information about the registered 
  691.     workplace object classes. 
  692.  
  693.  
  694. ΓòÉΓòÉΓòÉ <hidden> WinEnumObjectClasses Parameter - pSize ΓòÉΓòÉΓòÉ
  695.  
  696.  pSize (PULONG) - in/out 
  697.     Length of the pObjClass buffer in bytes. 
  698.  
  699.     If pObjClass is NULL, the actual size of pObjClass is returned in pSize 
  700.  
  701.  
  702. ΓòÉΓòÉΓòÉ <hidden> WinEnumObjectClasses Return Value - rc ΓòÉΓòÉΓòÉ
  703.  
  704.  rc (BOOL) - returns 
  705.     Success indicator. 
  706.  
  707.       TRUE 
  708.          Successful completion 
  709.       FALSE 
  710.          Error occurred. 
  711.  
  712.  
  713. ΓòÉΓòÉΓòÉ <hidden> WinEnumObjectClasses - Parameters ΓòÉΓòÉΓòÉ
  714.  
  715.  pObjClass (POBJCLASS) - input 
  716.     Pointer to object class. 
  717.  
  718.     A pointer to a buffer to be filled with information about the registered 
  719.     workplace object classes. 
  720.  
  721.  pSize (PULONG) - in/out 
  722.     Length of the pObjClass buffer in bytes. 
  723.  
  724.     If pObjClass is NULL, the actual size of pObjClass is returned in pSize 
  725.  
  726.  rc (BOOL) - returns 
  727.     Success indicator. 
  728.  
  729.       TRUE 
  730.          Successful completion 
  731.       FALSE 
  732.          Error occurred. 
  733.  
  734.  
  735. ΓòÉΓòÉΓòÉ <hidden> WinEnumObjectClasses - Remarks ΓòÉΓòÉΓòÉ
  736.  
  737. WinEnumObjectClasses will return a buffer containing all workplace object 
  738. classes that are currently registered with the system. Workplace object classes 
  739. are registered with the system through the function call 
  740. WinRegisterObjectClass. 
  741.  
  742.  
  743. ΓòÉΓòÉΓòÉ <hidden> WinEnumObjectClasses - Related Functions ΓòÉΓòÉΓòÉ
  744.  
  745.    o  WinRegisterObjectClass 
  746.    o  WinReplaceObjectClass 
  747.  
  748.  
  749. ΓòÉΓòÉΓòÉ <hidden> WinEnumObjectClasses - Topics ΓòÉΓòÉΓòÉ
  750.  
  751. Select an item: 
  752.  
  753. Syntax
  754. Parameters
  755. Returns
  756. Remarks
  757. Related Functions
  758. Glossary
  759.  
  760.  
  761. ΓòÉΓòÉΓòÉ 1.7. WinFreeFileIcon ΓòÉΓòÉΓòÉ
  762.  
  763.  
  764. ΓòÉΓòÉΓòÉ <hidden> WinFreeFileIcon - Syntax ΓòÉΓòÉΓòÉ
  765.  
  766. /*******************************************/
  767. /* This function frees an icon pointer     */
  768. /* that was originally allocated by        */
  769. /* WinLoadFileIcon.                        */
  770. /*******************************************/
  771.  
  772. #define INCL_WINWORKPLACE
  773. #include <os2.h>
  774.  
  775. HPOINTER    hptr;  /*  A pointer to an icon loaded by WinLoadFileIcon. */
  776. BOOL        rc;    /*  Success indicator. */
  777.  
  778. rc = WinFreeFileIcon(hptr);
  779.  
  780.  
  781. ΓòÉΓòÉΓòÉ <hidden> WinFreeFileIcon Parameter - hptr ΓòÉΓòÉΓòÉ
  782.  
  783.  hptr (HPOINTER) - input 
  784.     A pointer to an icon loaded by WinLoadFileIcon. 
  785.  
  786.  
  787. ΓòÉΓòÉΓòÉ <hidden> WinFreeFileIcon Return Value - rc ΓòÉΓòÉΓòÉ
  788.  
  789.  rc (BOOL) - returns 
  790.     Success indicator. 
  791.  
  792.       TRUE 
  793.          Successful completion 
  794.       FALSE 
  795.          Error occurred. 
  796.  
  797.  
  798. ΓòÉΓòÉΓòÉ <hidden> WinFreeFileIcon - Parameters ΓòÉΓòÉΓòÉ
  799.  
  800.  hptr (HPOINTER) - input 
  801.     A pointer to an icon loaded by WinLoadFileIcon. 
  802.  
  803.  rc (BOOL) - returns 
  804.     Success indicator. 
  805.  
  806.       TRUE 
  807.          Successful completion 
  808.       FALSE 
  809.          Error occurred. 
  810.  
  811.  
  812. ΓòÉΓòÉΓòÉ <hidden> WinFreeFileIcon - Related Functions ΓòÉΓòÉΓòÉ
  813.  
  814.    o  WinSetFileIcon 
  815.    o  WinLoadFileIcon 
  816.  
  817.  
  818. ΓòÉΓòÉΓòÉ <hidden> WinFreeFileIcon - Topics ΓòÉΓòÉΓòÉ
  819.  
  820. Select an item: 
  821.  
  822. Syntax
  823. Parameters
  824. Returns
  825. Related Functions
  826. Glossary
  827.  
  828.  
  829. ΓòÉΓòÉΓòÉ 1.8. WinIsSOMDDReady ΓòÉΓòÉΓòÉ
  830.  
  831.  
  832. ΓòÉΓòÉΓòÉ <hidden> WinIsSOMDDReady - Syntax ΓòÉΓòÉΓòÉ
  833.  
  834. /*******************************************/
  835. /* This function returns the current state */
  836. /* of the DSOM daemon started by the       */
  837. /* Workplace Shell process using the       */
  838. /* WinRestartSOMDD.                        */
  839. /*******************************************/
  840.  
  841. #define INCL_WPCLASS
  842. #include <os2.h>
  843.  
  844. BOOL    fReady;  /*  Flag indicating the DSOM daemon status. */
  845.  
  846. fReady = WinIsSOMDDReady();
  847.  
  848.  
  849. ΓòÉΓòÉΓòÉ <hidden> WinIsSOMDDReady Return Value - fReady ΓòÉΓòÉΓòÉ
  850.  
  851.  fReady (BOOL) - returns 
  852.     Flag indicating the DSOM daemon status. 
  853.  
  854.       TRUE 
  855.          SOMDD has been started by the Workplace Shell process. 
  856.       FALSE 
  857.          SOMDD has not been started by the Workplace Shell process. 
  858.  
  859.  
  860. ΓòÉΓòÉΓòÉ <hidden> WinIsSOMDDReady - Parameters ΓòÉΓòÉΓòÉ
  861.  
  862.  fReady (BOOL) - returns 
  863.     Flag indicating the DSOM daemon status. 
  864.  
  865.       TRUE 
  866.          SOMDD has been started by the Workplace Shell process. 
  867.       FALSE 
  868.          SOMDD has not been started by the Workplace Shell process. 
  869.  
  870.  
  871. ΓòÉΓòÉΓòÉ <hidden> WinIsSOMDDReady - Remarks ΓòÉΓòÉΓòÉ
  872.  
  873. This function returns the state of the DSOM daemon started only by the 
  874. Workplace Shell process using a call to WinRestartSOMDD. This does not include 
  875. the status of the DSOM daemon if started by any other process. 
  876.  
  877. Note:  This function requires that the PM Shell is up and running. 
  878.  
  879.  
  880. ΓòÉΓòÉΓòÉ <hidden> WinIsSOMDDReady - Related Functions ΓòÉΓòÉΓòÉ
  881.  
  882.    o  WinIsWPDServerReady 
  883.    o  WinRestartSOMDD 
  884.    o  WinRestartWPDServer 
  885.  
  886.  
  887. ΓòÉΓòÉΓòÉ <hidden> WinIsSOMDDReady - Example Code ΓòÉΓòÉΓòÉ
  888.  
  889. This example starts the DSOM daemon and, a short time later, checks to see if 
  890. it indeed has started successfully. 
  891.  
  892. #define  INCL_WPCLASS
  893. #include <os2.h>
  894.  
  895. WinRestartSOMDD();
  896.   .
  897.   .
  898.   .
  899. if ( WinIsSOMDDReady() )
  900.    somPrintf ("SOMDD is running\n")
  901. else
  902.    somPrintf ("SOMDD failed to start, possiblly started already"
  903.                "by another process\n");
  904.  
  905.  
  906. ΓòÉΓòÉΓòÉ <hidden> WinIsSOMDDReady - Topics ΓòÉΓòÉΓòÉ
  907.  
  908. Select an item: 
  909.  
  910. Syntax
  911. Parameters
  912. Returns
  913. Remarks
  914. Example Code
  915. Related Functions
  916. Glossary
  917.  
  918.  
  919. ΓòÉΓòÉΓòÉ 1.9. WinIsWPDServerReady ΓòÉΓòÉΓòÉ
  920.  
  921.  
  922. ΓòÉΓòÉΓòÉ <hidden> WinIsWPDServerReady - Syntax ΓòÉΓòÉΓòÉ
  923.  
  924. /*******************************************/
  925. /* This function returns the current state */
  926. /* of the Workplace Shell DSOM Server.     */
  927. /*******************************************/
  928.  
  929. #define INCL_WPCLASS
  930. #include <os2.h>
  931.  
  932. BOOL    fReady;  /*  Flag indicating the Workplace Shell DSOM Server status. */
  933.  
  934. fReady = WinIsWPDServerReady();
  935.  
  936.  
  937. ΓòÉΓòÉΓòÉ <hidden> WinIsWPDServerReady Return Value - fReady ΓòÉΓòÉΓòÉ
  938.  
  939.  fReady (BOOL) - returns 
  940.     Flag indicating the Workplace Shell DSOM Server status. 
  941.  
  942.       TRUE 
  943.          Workplace Shell DSOM Server is ready. 
  944.       FALSE 
  945.          Workplace Shell DSOM Server is not ready. 
  946.  
  947.  
  948. ΓòÉΓòÉΓòÉ <hidden> WinIsWPDServerReady - Parameters ΓòÉΓòÉΓòÉ
  949.  
  950.  fReady (BOOL) - returns 
  951.     Flag indicating the Workplace Shell DSOM Server status. 
  952.  
  953.       TRUE 
  954.          Workplace Shell DSOM Server is ready. 
  955.       FALSE 
  956.          Workplace Shell DSOM Server is not ready. 
  957.  
  958.  
  959. ΓòÉΓòÉΓòÉ <hidden> WinIsWPDServerReady - Remarks ΓòÉΓòÉΓòÉ
  960.  
  961. This function returns the ready status of the Workplace Shell DSOM Server. 
  962.  
  963. Note:  This function requires that the PM Shell is up and running. 
  964.  
  965.  
  966. ΓòÉΓòÉΓòÉ <hidden> WinIsWPDServerReady - Related Functions ΓòÉΓòÉΓòÉ
  967.  
  968.    o  WinIsSOMDDReady 
  969.    o  WinRestartSOMDD 
  970.    o  WinRestartWPDServer 
  971.  
  972.  
  973. ΓòÉΓòÉΓòÉ <hidden> WinIsWPDServerReady - Example Code ΓòÉΓòÉΓòÉ
  974.  
  975. This example stops the Workplace Shell DSOM Server, then waits until the server 
  976. has terminate before stopping the DSOM daemon. 
  977.  
  978. #define  INCL_WPCLASS
  979. #include <os2.h>
  980.  
  981. ULONG  count=0;
  982. enum   {ON, OFF};
  983.  
  984. WinRestartWPDServer(OFF);
  985.  
  986. /* Make sure the server thread has terminated completely before */
  987. /* bring down the DSOM daemon                                   */
  988. while ( WinIsWPDServerReady() )
  989. {
  990.    HEV hev;
  991.  
  992.    /* First create a private, reset, event semaphore.           */
  993.    DosCreateEventSem( (PSZ)NULL, &hev, 0, FALSE);
  994.  
  995.    /* Wait for 1 second; then try again for a max. of 30 sec.   */
  996.    DosWaitEventSem (hev, 1000);
  997.    if (count++ > 30)
  998.       break;
  999. }
  1000. WinRestartSOMDD (OFF);
  1001.  
  1002.  
  1003. ΓòÉΓòÉΓòÉ <hidden> WinIsWPDServerReady - Topics ΓòÉΓòÉΓòÉ
  1004.  
  1005. Select an item: 
  1006.  
  1007. Syntax
  1008. Parameters
  1009. Returns
  1010. Remarks
  1011. Example Code
  1012. Related Functions
  1013. Glossary
  1014.  
  1015.  
  1016. ΓòÉΓòÉΓòÉ 1.10. WinLoadFileIcon ΓòÉΓòÉΓòÉ
  1017.  
  1018.  
  1019. ΓòÉΓòÉΓòÉ <hidden> WinLoadFileIcon - Syntax ΓòÉΓòÉΓòÉ
  1020.  
  1021. /*******************************************/
  1022. /* This function returns a pointer to an   */
  1023. /* icon which is associated with the file  */
  1024. /* specified by pFileName.                 */
  1025. /*******************************************/
  1026.  
  1027. #define INCL_WINWORKPLACE
  1028. #include <os2.h>
  1029.  
  1030. PSZ         pFileName;  /*  Pointer to file name. */
  1031. BOOL        fPrivate;   /*  Icon usage flag. */
  1032. HPOINTER    rc;         /*  Success indicator. */
  1033.  
  1034. rc = WinLoadFileIcon(pFileName, fPrivate);
  1035.  
  1036.  
  1037. ΓòÉΓòÉΓòÉ <hidden> WinLoadFileIcon Parameter - pFileName ΓòÉΓòÉΓòÉ
  1038.  
  1039.  pFileName (PSZ) - input 
  1040.     Pointer to file name. 
  1041.  
  1042.     A pointer to a zero-terminated string which contains the name of the file 
  1043.     whose icon will be loaded. 
  1044.  
  1045.  
  1046. ΓòÉΓòÉΓòÉ <hidden> WinLoadFileIcon Parameter - fPrivate ΓòÉΓòÉΓòÉ
  1047.  
  1048.  fPrivate (BOOL) - input 
  1049.     Icon usage flag. 
  1050.  
  1051.       TRUE 
  1052.          A private copy of this icon is requested. This flag should be used if 
  1053.          the application needs to modify the icon. 
  1054.  
  1055.       FALSE 
  1056.          A shared pointer to this icon is requested. This flag should be used 
  1057.          if application needs to display the icon without modifying it.  This 
  1058.          should be used whenever possible to optimize system resource use. 
  1059.  
  1060.  
  1061. ΓòÉΓòÉΓòÉ <hidden> WinLoadFileIcon Return Value - rc ΓòÉΓòÉΓòÉ
  1062.  
  1063.  rc (HPOINTER) - returns 
  1064.     Success indicator. 
  1065.  
  1066.       NULL 
  1067.          Error occurred. 
  1068.       OTHER 
  1069.          Handle to an icon. 
  1070.  
  1071.  
  1072. ΓòÉΓòÉΓòÉ <hidden> WinLoadFileIcon - Parameters ΓòÉΓòÉΓòÉ
  1073.  
  1074.  pFileName (PSZ) - input 
  1075.     Pointer to file name. 
  1076.  
  1077.     A pointer to a zero-terminated string which contains the name of the file 
  1078.     whose icon will be loaded. 
  1079.  
  1080.  fPrivate (BOOL) - input 
  1081.     Icon usage flag. 
  1082.  
  1083.       TRUE 
  1084.          A private copy of this icon is requested. This flag should be used if 
  1085.          the application needs to modify the icon. 
  1086.  
  1087.       FALSE 
  1088.          A shared pointer to this icon is requested. This flag should be used 
  1089.          if application needs to display the icon without modifying it.  This 
  1090.          should be used whenever possible to optimize system resource use. 
  1091.  
  1092.  rc (HPOINTER) - returns 
  1093.     Success indicator. 
  1094.  
  1095.       NULL 
  1096.          Error occurred. 
  1097.       OTHER 
  1098.          Handle to an icon. 
  1099.  
  1100.  
  1101. ΓòÉΓòÉΓòÉ <hidden> WinLoadFileIcon - Remarks ΓòÉΓòÉΓòÉ
  1102.  
  1103. The icon will be retrieved in the following order until an icon has been found: 
  1104.  
  1105.    o  .ICON extended attribute 
  1106.    o  .ICO file in same directory with same prefix 
  1107.    o  Application specific icon (if PM executable or MS Windows* executable) 
  1108.    o  PM application icon (if PM executable) 
  1109.    o  MS Windows* application icon (if MS Windows* application executable) 
  1110.    o  OS/2 application icon (if OS/2 full-screen only executable ) 
  1111.    o  OS/2 window icon (if OS/2 window compatible executable) 
  1112.    o  DOS windowed application icon (if DOS windowed executable) 
  1113.    o  Program application (if unknown type executable) 
  1114.    o  Data icon specified by associated application 
  1115.    o  Data icon of associated application 
  1116.    o  Data file icon (if not program or directory) 
  1117.    o  Directory icon (if directory) 
  1118.  
  1119.  The HPOINTER returned in fPrivate should be freed by the caller via 
  1120.  WinFreeFileIcon when it is no longer being used. 
  1121.  
  1122.  
  1123. ΓòÉΓòÉΓòÉ <hidden> WinLoadFileIcon - Related Functions ΓòÉΓòÉΓòÉ
  1124.  
  1125.    o  WinSetFileIcon 
  1126.    o  WinFreeFileIcon 
  1127.  
  1128.  
  1129. ΓòÉΓòÉΓòÉ <hidden> WinLoadFileIcon - Topics ΓòÉΓòÉΓòÉ
  1130.  
  1131. Select an item: 
  1132.  
  1133. Syntax
  1134. Parameters
  1135. Returns
  1136. Remarks
  1137. Related Functions
  1138. Glossary
  1139.  
  1140.  
  1141. ΓòÉΓòÉΓòÉ 1.11. WinMoveObject ΓòÉΓòÉΓòÉ
  1142.  
  1143.  
  1144. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject - Syntax ΓòÉΓòÉΓòÉ
  1145.  
  1146. /*******************************************/
  1147. /* This function is specific to version 3, */
  1148. /* or higher, of the OS/2 operating        */
  1149. /* system.  This function moves an object  */
  1150. /* from its existing location to a         */
  1151. /* specified new destination.              */
  1152. /*******************************************/
  1153.  
  1154. #define INCL_WINWORKPLACE
  1155. #include <os2.h>
  1156.  
  1157. HOBJECT    hObjectofObject;  /*  Handle of the Workplace Shell object being moved. */
  1158. HOBJECT    hObjectofDest;    /*  Handle of the destination folder into which hObjectofObject is to be moved. */
  1159. ULONG      ulFlags;          /*  Move Flags. */
  1160. HOBJECT    rc;               /*  Handle of the source object being moved. */
  1161.  
  1162. rc = WinMoveObject(hObjectofObject, hObjectofDest,
  1163.        ulFlags);
  1164.  
  1165.  
  1166. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject Parameter - hObjectofObject ΓòÉΓòÉΓòÉ
  1167.  
  1168.  hObjectofObject (HOBJECT) - input 
  1169.     Handle of the Workplace Shell object being moved. 
  1170.  
  1171.  
  1172. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject Parameter - hObjectofDest ΓòÉΓòÉΓòÉ
  1173.  
  1174.  hObjectofDest (HOBJECT) - input 
  1175.     Handle of the destination folder into which hObjectofObject is to be moved. 
  1176.  
  1177.  
  1178. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject Parameter - ulFlags ΓòÉΓòÉΓòÉ
  1179.  
  1180.  ulFlags (ULONG) - input 
  1181.     Move Flags. 
  1182.  
  1183.       MOVE_FAILIFEXSTS 
  1184.  
  1185.  
  1186. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject Return Value - rc ΓòÉΓòÉΓòÉ
  1187.  
  1188.  rc (HOBJECT) - returns 
  1189.     Handle of the source object being moved. 
  1190.  
  1191.     A return value of NULLHANDLE indicates that either hObjectofDest is 
  1192.     NULLHANDLE or an object with the same name as hObjectofObject exists in the 
  1193.     destination folder. 
  1194.  
  1195.  
  1196. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject - Parameters ΓòÉΓòÉΓòÉ
  1197.  
  1198.  hObjectofObject (HOBJECT) - input 
  1199.     Handle of the Workplace Shell object being moved. 
  1200.  
  1201.  hObjectofDest (HOBJECT) - input 
  1202.     Handle of the destination folder into which hObjectofObject is to be moved. 
  1203.  
  1204.  ulFlags (ULONG) - input 
  1205.     Move Flags. 
  1206.  
  1207.       MOVE_FAILIFEXSTS 
  1208.  
  1209.  rc (HOBJECT) - returns 
  1210.     Handle of the source object being moved. 
  1211.  
  1212.     A return value of NULLHANDLE indicates that either hObjectofDest is 
  1213.     NULLHANDLE or an object with the same name as hObjectofObject exists in the 
  1214.     destination folder. 
  1215.  
  1216.  
  1217. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject - Remarks ΓòÉΓòÉΓòÉ
  1218.  
  1219. Using HOBJECT for .INI files or files in which an application uses a 
  1220. rename/save/delete sequence is not supported. Its REXX counterpart is 
  1221. SysMoveObject. 
  1222.  
  1223.  
  1224. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject - Errors ΓòÉΓòÉΓòÉ
  1225.  
  1226. Possible returns from WinGetLastError 
  1227.  
  1228.  WPERR_INVALID_FLAGS (0x1719) 
  1229.     An invalid flag was specified. 
  1230.  
  1231.  
  1232. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject - Related Functions ΓòÉΓòÉΓòÉ
  1233.  
  1234.    o  WinCopyObject 
  1235.    o  WinCreateObject. 
  1236.    o  WinDestroyObject 
  1237.    o  WinQueryObjectWindow 
  1238.    o  WinSaveObject 
  1239.  
  1240.  
  1241. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject - Example Code ΓòÉΓòÉΓòÉ
  1242.  
  1243. This example moves the drives object onto the Desktop. 
  1244.  
  1245. #define INCL_WINWORKPLACE
  1246. #include "os2.h"
  1247.  
  1248. HOBJECT    hObjectofDest;
  1249. HOBJECT    hObjectofObject;
  1250. HOBJECT    hObjectofResult;
  1251.  
  1252. hObjectofObject = WinQueryObject("<WP_DRIVES>");
  1253. if (hObjectofObject != NULL)
  1254.   {
  1255.     /* WinQueryObject of Drives was successful */
  1256.  
  1257.     hObjectofDest = WinQueryObject("<WP_DESKTOP>");
  1258.     if (hObjectofDest != NULL)
  1259.     {
  1260.          /* WinQueryObject of Startup was successful */
  1261.  
  1262.          hObjectofResult = WinMoveObject(hObjectofObject, hObjectofDest,MOVE_FAILIFEXISTS);
  1263.  
  1264.         if (hObjectofResult != NULL)
  1265.         {
  1266.              /* Drives Object was successfully copied to the Desktop */
  1267.         }
  1268.         else
  1269.         {
  1270.              /* Move failed */
  1271.  
  1272.         }
  1273.  
  1274.  
  1275. ΓòÉΓòÉΓòÉ <hidden> WinMoveObject - Topics ΓòÉΓòÉΓòÉ
  1276.  
  1277. Select an item: 
  1278.  
  1279. Syntax
  1280. Parameters
  1281. Returns
  1282. Errors
  1283. Remarks
  1284. Example Code
  1285. Related Functions
  1286. Glossary
  1287.  
  1288.  
  1289. ΓòÉΓòÉΓòÉ 1.12. WinOpenObject ΓòÉΓòÉΓòÉ
  1290.  
  1291.  
  1292. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject - Syntax ΓòÉΓòÉΓòÉ
  1293.  
  1294. /*******************************************/
  1295. /* This function is specific to version 3, */
  1296. /* or higher, of the OS/2 operating        */
  1297. /* system.  This function eithers opens a  */
  1298. /* view of the given object or surfaces an */
  1299. /* existing view.                          */
  1300. /*******************************************/
  1301.  
  1302. #define INCL_WINWORKPLACE
  1303. #include <os2.h>
  1304.  
  1305. HOBJECT    hObjectofObject;  /*  Handle to a Workplace Shell object to be opened. */
  1306. ULONG      ulView;           /*  View in which to open the specified object. */
  1307. BOOL       fFlags;           /*  Flags. */
  1308. BOOL       rc;               /*  Success indicator. */
  1309.  
  1310. rc = WinOpenObject(hObjectofObject, ulView,
  1311.        fFlags);
  1312.  
  1313.  
  1314. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject Parameter - hObjectofObject ΓòÉΓòÉΓòÉ
  1315.  
  1316.  hObjectofObject (HOBJECT) - input 
  1317.     Handle to a Workplace Shell object to be opened. 
  1318.  
  1319.  
  1320. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject Parameter - ulView ΓòÉΓòÉΓòÉ
  1321.  
  1322.  ulView (ULONG) - input 
  1323.     View in which to open the specified object. 
  1324.  
  1325.       OPEN_SETTINGS 
  1326.  
  1327.       OPEN_TREE 
  1328.  
  1329.       OPEN_DEFAULT 
  1330.  
  1331.       OPEN_CONTENTS 
  1332.  
  1333.       OPEN_DETAILS 
  1334.  
  1335.  
  1336. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject Parameter - fFlags ΓòÉΓòÉΓòÉ
  1337.  
  1338.  fFlags (BOOL) - input 
  1339.     Flags. 
  1340.  
  1341.       TRUE 
  1342.          Open a view of the object which already exists and supports concurrent 
  1343.          views, by calling wpViewObject. 
  1344.       FALSE 
  1345.          Open a view of this object by calling wpOpen. 
  1346.  
  1347.  
  1348. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject Return Value - rc ΓòÉΓòÉΓòÉ
  1349.  
  1350.  rc (BOOL) - returns 
  1351.     Success indicator. 
  1352.  
  1353.       TRUE 
  1354.          Successful completion 
  1355.       FALSE 
  1356.          Error occurred. 
  1357.  
  1358.  
  1359. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject - Parameters ΓòÉΓòÉΓòÉ
  1360.  
  1361.  hObjectofObject (HOBJECT) - input 
  1362.     Handle to a Workplace Shell object to be opened. 
  1363.  
  1364.  ulView (ULONG) - input 
  1365.     View in which to open the specified object. 
  1366.  
  1367.       OPEN_SETTINGS 
  1368.  
  1369.       OPEN_TREE 
  1370.  
  1371.       OPEN_DEFAULT 
  1372.  
  1373.       OPEN_CONTENTS 
  1374.  
  1375.       OPEN_DETAILS 
  1376.  
  1377.  fFlags (BOOL) - input 
  1378.     Flags. 
  1379.  
  1380.       TRUE 
  1381.          Open a view of the object which already exists and supports concurrent 
  1382.          views, by calling wpViewObject. 
  1383.       FALSE 
  1384.          Open a view of this object by calling wpOpen. 
  1385.  
  1386.  rc (BOOL) - returns 
  1387.     Success indicator. 
  1388.  
  1389.       TRUE 
  1390.          Successful completion 
  1391.       FALSE 
  1392.          Error occurred. 
  1393.  
  1394.  
  1395. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject - Remarks ΓòÉΓòÉΓòÉ
  1396.  
  1397. Using HOBJECT for .INI files or files in which an application uses a 
  1398. rename/save/delete sequence is not supported. Its REXX counterpart is 
  1399. SysOpenObject. If concurrent views is off, wpViewObject will resurface an 
  1400. existing object. 
  1401.  
  1402.  
  1403. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject - Related Functions ΓòÉΓòÉΓòÉ
  1404.  
  1405.    o  WinCreateObject 
  1406.    o  WinDestroyObject 
  1407.    o  WinSaveObject 
  1408.  
  1409.  
  1410. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject - Example Code ΓòÉΓòÉΓòÉ
  1411.  
  1412. #define INCL_WINWORKPLACE
  1413. #include "os2.h"
  1414.  
  1415. HOBJECT hObject;
  1416. ULONG   ulView;
  1417. BOOL    fFlags
  1418. BOOL    fSuccess;
  1419.  
  1420. hObject = WinQueryObject("<WP_DESKTOP>");
  1421. if (hObject != NULL)
  1422.   {
  1423.     /* WinQueryObject was successful */
  1424.  
  1425.     fSuccess = WinOpenObject(hObject, OPEN_SETTINGS,TRUE);
  1426.  
  1427.     if (fSuccess)
  1428.     {
  1429.        /* If concurrent views is off and a settings view of the desktop already
  1430.         * exits, then it was successfully resurfaced.
  1431.         *
  1432.         * If concurrent views is on then another settings view of the desktop
  1433.         * was successfully opened
  1434.        */
  1435.     }
  1436.     else
  1437.     {
  1438.        /* WinOpenObject failed */
  1439.  
  1440.     }
  1441.  
  1442.  
  1443. ΓòÉΓòÉΓòÉ <hidden> WinOpenObject - Topics ΓòÉΓòÉΓòÉ
  1444.  
  1445. Select an item: 
  1446.  
  1447. Syntax
  1448. Parameters
  1449. Returns
  1450. Remarks
  1451. Example Code
  1452. Related Functions
  1453. Glossary
  1454.  
  1455.  
  1456. ΓòÉΓòÉΓòÉ 1.13. WinQueryActiveDesktopPathname ΓòÉΓòÉΓòÉ
  1457.  
  1458.  
  1459. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname - Syntax ΓòÉΓòÉΓòÉ
  1460.  
  1461. /*******************************************/
  1462. /* This function is specific to version 3, */
  1463. /* or higher, of the OS/2 operating        */
  1464. /* system.  This function returns the      */
  1465. /* directory specification of the active   */
  1466. /* desktop.                                */
  1467. /*******************************************/
  1468.  
  1469. #define INCL_WINWORKPLACE
  1470. #include <os2.h>
  1471.  
  1472. PSZ      pszPathName;  /*  Memory allocated by caller in which directory specification is written. */
  1473. ULONG    ulSize;       /*  Number of bytes pointed to by pszPathName. */
  1474. BOOL     rc;           /*  Success indicator. */
  1475.  
  1476. rc = WinQueryActiveDesktopPathname(pszPathName,
  1477.        ulSize);
  1478.  
  1479.  
  1480. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname Parameter - pszPathName ΓòÉΓòÉΓòÉ
  1481.  
  1482.  pszPathName (PSZ) - output 
  1483.     Memory allocated by caller in which directory specification is written. 
  1484.  
  1485.  
  1486. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname Parameter - ulSize ΓòÉΓòÉΓòÉ
  1487.  
  1488.  ulSize (ULONG) - input 
  1489.     Number of bytes pointed to by pszPathName. 
  1490.  
  1491.  
  1492. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname Return Value - rc ΓòÉΓòÉΓòÉ
  1493.  
  1494.  rc (BOOL) - returns 
  1495.     Success indicator. 
  1496.  
  1497.       TRUE 
  1498.          Successful completion 
  1499.       FALSE 
  1500.          Error occurred. 
  1501.  
  1502.  
  1503. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname - Parameters ΓòÉΓòÉΓòÉ
  1504.  
  1505.  pszPathName (PSZ) - output 
  1506.     Memory allocated by caller in which directory specification is written. 
  1507.  
  1508.  ulSize (ULONG) - input 
  1509.     Number of bytes pointed to by pszPathName. 
  1510.  
  1511.  rc (BOOL) - returns 
  1512.     Success indicator. 
  1513.  
  1514.       TRUE 
  1515.          Successful completion 
  1516.       FALSE 
  1517.          Error occurred. 
  1518.  
  1519.  
  1520. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname - Remarks ΓòÉΓòÉΓòÉ
  1521.  
  1522. This function is used to find the directory specification of the current 
  1523. desktop. The current desktop is not always \DESKTOP of the boot drive. 
  1524.  
  1525.  
  1526. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname - Errors ΓòÉΓòÉΓòÉ
  1527.  
  1528. Possible returns from WinGetLastError 
  1529.  
  1530.  PMERR_INVALID_PARAMETER (0x1645) 
  1531.     An application parameter value is invalid for its converted PM type. For 
  1532.     example: a 4-byte value outside the range -32,768 to +32,767 cannot be 
  1533.     converted to a SHORT, and a negative number cannot be converted to a ULONG 
  1534.     or USHORT. 
  1535.  
  1536.  
  1537. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname - Example Code ΓòÉΓòÉΓòÉ
  1538.  
  1539. This example finds the directory specification of the current desktop. 
  1540.  
  1541. #define INCL_WINWORKPLACE
  1542. #include <os2.h>
  1543.  
  1544. CHAR    szPath[CCHMAXPATH + 1];
  1545. BOOL    fSuccess;
  1546.  
  1547. fSuccess = WinQueryActiveDesktopPathname(szPath,sizeof(szPath));
  1548. if (fSuccess)
  1549. {
  1550.   /* WinQueryActiveDesktopPathname was successful */
  1551. }
  1552. else
  1553. {
  1554.   /* WinQueryActiveDesktopPathname failed */
  1555. }
  1556.  
  1557.  
  1558. ΓòÉΓòÉΓòÉ <hidden> WinQueryActiveDesktopPathname - Topics ΓòÉΓòÉΓòÉ
  1559.  
  1560. Select an item: 
  1561.  
  1562. Syntax
  1563. Parameters
  1564. Returns
  1565. Errors
  1566. Remarks
  1567. Example Code
  1568. Glossary
  1569.  
  1570.  
  1571. ΓòÉΓòÉΓòÉ 1.14. WinQueryObject ΓòÉΓòÉΓòÉ
  1572.  
  1573.  
  1574. ΓòÉΓòÉΓòÉ <hidden> WinQueryObject - Syntax ΓòÉΓòÉΓòÉ
  1575.  
  1576. /*******************************************/
  1577. /* The WinQueryObject function returns a   */
  1578. /* handle to the given object.             */
  1579. /*******************************************/
  1580.  
  1581. #define INCL_WINWORKPLACE
  1582. #include <os2.h>
  1583.  
  1584. PSZ        pObjectID;  /*  The object ID of an existing object. */
  1585. HOBJECT    hObject;    /*  MRESULT. */
  1586.  
  1587. hObject = WinQueryObject(pObjectID);
  1588.  
  1589.  
  1590. ΓòÉΓòÉΓòÉ <hidden> WinQueryObject Parameter - pObjectID ΓòÉΓòÉΓòÉ
  1591.  
  1592.  pObjectID (PSZ) - input 
  1593.     The object ID of an existing object. 
  1594.  
  1595.     The object ID of an existing object, for example <LOCATION_DESKTOP>, or 
  1596.     alternatively the fully qualified filename of any file or directory. 
  1597.  
  1598.  
  1599. ΓòÉΓòÉΓòÉ <hidden> WinQueryObject Return Value - hObject ΓòÉΓòÉΓòÉ
  1600.  
  1601.  hObject (HOBJECT) - returns 
  1602.     MRESULT. 
  1603.  
  1604.     Persistent object handle, or NULLHANDLE if the object does not exist or 
  1605.     could not be awakened. 
  1606.  
  1607.  
  1608. ΓòÉΓòÉΓòÉ <hidden> WinQueryObject - Parameters ΓòÉΓòÉΓòÉ
  1609.  
  1610.  pObjectID (PSZ) - input 
  1611.     The object ID of an existing object. 
  1612.  
  1613.     The object ID of an existing object, for example <LOCATION_DESKTOP>, or 
  1614.     alternatively the fully qualified filename of any file or directory. 
  1615.  
  1616.  hObject (HOBJECT) - returns 
  1617.     MRESULT. 
  1618.  
  1619.     Persistent object handle, or NULLHANDLE if the object does not exist or 
  1620.     could not be awakened. 
  1621.  
  1622.  
  1623. ΓòÉΓòÉΓòÉ <hidden> WinQueryObject - Remarks ΓòÉΓòÉΓòÉ
  1624.  
  1625. This function allows you to obtain the persistant object handle for any file 
  1626. object, by passing the fully qualified filename. Similarly any objects' handle 
  1627. can be retrieved if its object ID string is passed. Once a program has an 
  1628. object handle, it is able to change the objects state by using the 
  1629. WinSetObjectData function or delete the object using the WinDestroyObject 
  1630. function. Note that valid object ID strings must always start with the "<" 
  1631. character and be terminated by the ">" character, and are thus invalid file 
  1632. system names. 
  1633.  
  1634. Using HOBJECT for .INI files or files in which an application uses a 
  1635. rename/save/delete sequence is not supported. 
  1636.  
  1637.  
  1638. ΓòÉΓòÉΓòÉ <hidden> WinQueryObject - Related Functions ΓòÉΓòÉΓòÉ
  1639.  
  1640.    o  WinCreateObject 
  1641.    o  WinDestroyObject 
  1642.    o  WinSetObjectData 
  1643.  
  1644.  
  1645. ΓòÉΓòÉΓòÉ <hidden> WinQueryObject - Topics ΓòÉΓòÉΓòÉ
  1646.  
  1647. Select an item: 
  1648.  
  1649. Syntax
  1650. Parameters
  1651. Returns
  1652. Remarks
  1653. Related Functions
  1654. Glossary
  1655.  
  1656.  
  1657. ΓòÉΓòÉΓòÉ 1.15. WinQueryObjectPath ΓòÉΓòÉΓòÉ
  1658.  
  1659.  
  1660. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath - Syntax ΓòÉΓòÉΓòÉ
  1661.  
  1662. /*******************************************/
  1663. /* This function is specific to version 3, */
  1664. /* or higher, of the OS/2 operating        */
  1665. /* system.  This function returns the      */
  1666. /* directory specification of a given      */
  1667. /* object handle.                          */
  1668. /*******************************************/
  1669.  
  1670. #define INCL_WINWORKPLACE
  1671. #include <os2.h>
  1672.  
  1673. HOBJECT    hObject;      /*  Object handle of the object whose file/directory specification is to be returned. */
  1674. PSZ        pszPathname;  /*  Memory allocated by caller in which directory specification is written. */
  1675. ULONG      ulSize;       /*  Number of bytes pointed to by pszPathname. */
  1676. BOOL       rc;           /*  Success indicator. */
  1677.  
  1678. rc = WinQueryObjectPath(hObject, pszPathname,
  1679.        ulSize);
  1680.  
  1681.  
  1682. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath Parameter - hObject ΓòÉΓòÉΓòÉ
  1683.  
  1684.  hObject (HOBJECT) - input 
  1685.     Object handle of the object whose file/directory specification is to be 
  1686.     returned. 
  1687.  
  1688.  
  1689. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath Parameter - pszPathname ΓòÉΓòÉΓòÉ
  1690.  
  1691.  pszPathname (PSZ) - output 
  1692.     Memory allocated by caller in which directory specification is written. 
  1693.  
  1694.  
  1695. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath Parameter - ulSize ΓòÉΓòÉΓòÉ
  1696.  
  1697.  ulSize (ULONG) - input 
  1698.     Number of bytes pointed to by pszPathname. 
  1699.  
  1700.  
  1701. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath Return Value - rc ΓòÉΓòÉΓòÉ
  1702.  
  1703.  rc (BOOL) - returns 
  1704.     Success indicator. 
  1705.  
  1706.       TRUE 
  1707.          Successful completion 
  1708.       FALSE 
  1709.          Error occurred. 
  1710.  
  1711.  
  1712. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath - Parameters ΓòÉΓòÉΓòÉ
  1713.  
  1714.  hObject (HOBJECT) - input 
  1715.     Object handle of the object whose file/directory specification is to be 
  1716.     returned. 
  1717.  
  1718.  pszPathname (PSZ) - output 
  1719.     Memory allocated by caller in which directory specification is written. 
  1720.  
  1721.  ulSize (ULONG) - input 
  1722.     Number of bytes pointed to by pszPathname. 
  1723.  
  1724.  rc (BOOL) - returns 
  1725.     Success indicator. 
  1726.  
  1727.       TRUE 
  1728.          Successful completion 
  1729.       FALSE 
  1730.          Error occurred. 
  1731.  
  1732.  
  1733. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath - Remarks ΓòÉΓòÉΓòÉ
  1734.  
  1735. This function is used to find the file/directory specification of a given 
  1736. object handle. 
  1737.  
  1738. Using HOBJECT for .INI files or files in which an application uses a 
  1739. rename/save/delete sequence is not supported. 
  1740.  
  1741.  
  1742. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath - Errors ΓòÉΓòÉΓòÉ
  1743.  
  1744. Possible returns from WinGetLastError 
  1745.  
  1746.  PMERR_INVALID_PARAMETERS (0x1208) 
  1747.     An application parameter value is invalid for its converted PM type. For 
  1748.     example: a 4-byte value outside the range -32 768 to +32 767 cannot be 
  1749.     converted to a SHORT, and a negative number cannot be converted to a ULONG 
  1750.     or USHORT. 
  1751.  
  1752.  
  1753. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath - Example Code ΓòÉΓòÉΓòÉ
  1754.  
  1755. This example finds the file/directory of the <WP_OS2SYS> object.. 
  1756.  
  1757. #define INCL_WINWORKPLACE
  1758. #include <os2.h>
  1759.  
  1760. HOBJECT hObject;
  1761. CHAR    szPath[CCHMAXPATH + 1];
  1762. BOOL    fSuccess;
  1763.  
  1764. hObject = WinQueryObject("<WP_OS2SYS>");
  1765. if (hObject != NULL)
  1766. {
  1767.   /* WinQueryObject was successful */
  1768.  
  1769.   fSuccess = WinQueryObjectPath(hObject,szPath,sizeof(szPath));
  1770.   if (fSuccess)
  1771.   {
  1772.     /* WinQueryObjectPath was successful */
  1773.   }
  1774.   else
  1775.   {
  1776.     /* WinQueryObjectPath failed */
  1777.   }
  1778. }
  1779. else
  1780. {
  1781.   /* WinQueryObject failed */
  1782. }
  1783.  
  1784.  
  1785. ΓòÉΓòÉΓòÉ <hidden> WinQueryObjectPath - Topics ΓòÉΓòÉΓòÉ
  1786.  
  1787. Select an item: 
  1788.  
  1789. Syntax
  1790. Parameters
  1791. Returns
  1792. Errors
  1793. Remarks
  1794. Example Code
  1795. Glossary
  1796.  
  1797.  
  1798. ΓòÉΓòÉΓòÉ 1.16. WinRegisterObjectClass ΓòÉΓòÉΓòÉ
  1799.  
  1800.  
  1801. ΓòÉΓòÉΓòÉ <hidden> WinRegisterObjectClass - Syntax ΓòÉΓòÉΓòÉ
  1802.  
  1803. /*******************************************/
  1804. /* The WinRegisterObjectClass function     */
  1805. /* registers a workplace object class.     */
  1806. /*******************************************/
  1807.  
  1808. #define INCL_WINWORKPLACE
  1809. #include <os2.h>
  1810.  
  1811. PSZ     pClassName;  /*  A pointer to object class being registered. */
  1812. PSZ     pModname;    /*  A pointer to DLL name. */
  1813. BOOL    rc;          /*  Success indicator. */
  1814.  
  1815. rc = WinRegisterObjectClass(pClassName, pModname);
  1816.  
  1817.  
  1818. ΓòÉΓòÉΓòÉ <hidden> WinRegisterObjectClass Parameter - pClassName ΓòÉΓòÉΓòÉ
  1819.  
  1820.  pClassName (PSZ) - input 
  1821.     A pointer to object class being registered. 
  1822.  
  1823.     A pointer to a zero-terminated string which contains the name of the object 
  1824.     class being registered in the workplace. 
  1825.  
  1826.  
  1827. ΓòÉΓòÉΓòÉ <hidden> WinRegisterObjectClass Parameter - pModname ΓòÉΓòÉΓòÉ
  1828.  
  1829.  pModname (PSZ) - input 
  1830.     A pointer to DLL name. 
  1831.  
  1832.     A pointer to a zero-terminated string which contains the name of the DLL 
  1833.     which holds the object definition. 
  1834.  
  1835.  
  1836. ΓòÉΓòÉΓòÉ <hidden> WinRegisterObjectClass Return Value - rc ΓòÉΓòÉΓòÉ
  1837.  
  1838.  rc (BOOL) - returns 
  1839.     Success indicator. 
  1840.  
  1841.       TRUE 
  1842.          Successful completion 
  1843.       FALSE 
  1844.          Error occurred. 
  1845.  
  1846.  
  1847. ΓòÉΓòÉΓòÉ <hidden> WinRegisterObjectClass - Parameters ΓòÉΓòÉΓòÉ
  1848.  
  1849.  pClassName (PSZ) - input 
  1850.     A pointer to object class being registered. 
  1851.  
  1852.     A pointer to a zero-terminated string which contains the name of the object 
  1853.     class being registered in the workplace. 
  1854.  
  1855.  pModname (PSZ) - input 
  1856.     A pointer to DLL name. 
  1857.  
  1858.     A pointer to a zero-terminated string which contains the name of the DLL 
  1859.     which holds the object definition. 
  1860.  
  1861.  rc (BOOL) - returns 
  1862.     Success indicator. 
  1863.  
  1864.       TRUE 
  1865.          Successful completion 
  1866.       FALSE 
  1867.          Error occurred. 
  1868.  
  1869.  
  1870. ΓòÉΓòÉΓòÉ <hidden> WinRegisterObjectClass - Remarks ΓòÉΓòÉΓòÉ
  1871.  
  1872. The DLL must be one created using the IBM System Object Model. Object classes 
  1873. will automatically be added to the system when installing a DLL which contains 
  1874. an object definition. Generally, it is not required for the object DLL to be 
  1875. present at the time WinRegisterObjectClass is called. However, if the object 
  1876. class overrides wpclsQueryInstanceType or  wpclsQueryInstanceFilter, the DLL 
  1877. must be present at the time of the class registration. 
  1878.  
  1879.  
  1880. ΓòÉΓòÉΓòÉ <hidden> WinRegisterObjectClass - Related Functions ΓòÉΓòÉΓòÉ
  1881.  
  1882.    o  WinCreateObject 
  1883.    o  WinDeregisterObjectClass 
  1884.    o  WinReplaceObjectClass 
  1885.  
  1886.  
  1887. ΓòÉΓòÉΓòÉ <hidden> WinRegisterObjectClass - Topics ΓòÉΓòÉΓòÉ
  1888.  
  1889. Select an item: 
  1890.  
  1891. Syntax
  1892. Parameters
  1893. Returns
  1894. Remarks
  1895. Related Functions
  1896. Glossary
  1897.  
  1898.  
  1899. ΓòÉΓòÉΓòÉ 1.17. WinReplaceObjectClass ΓòÉΓòÉΓòÉ
  1900.  
  1901.  
  1902. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass - Syntax ΓòÉΓòÉΓòÉ
  1903.  
  1904. /*******************************************/
  1905. /* The WinReplaceObjectClass function      */
  1906. /* replaces a registered class with        */
  1907. /* another registered class.  If fReplace  */
  1908. /* is FALSE, pOldClassName will revert     */
  1909. /* back to its original definition.        */
  1910. /*******************************************/
  1911.  
  1912. #define INCL_WINWORKPLACE
  1913. #include <os2.h>
  1914.  
  1915. PSZ     pOldClassName;  /*  Pointer to class name. */
  1916. PSZ     pNewClassName;  /*  Pointer to new class name. */
  1917. BOOL    fReplace;       /*  Function replacement flag. */
  1918. BOOL    rc;             /*  Success indicator. */
  1919.  
  1920. rc = WinReplaceObjectClass(pOldClassName,
  1921.        pNewClassName, fReplace);
  1922.  
  1923.  
  1924. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass Parameter - pOldClassName ΓòÉΓòÉΓòÉ
  1925.  
  1926.  pOldClassName (PSZ) - input 
  1927.     Pointer to class name. 
  1928.  
  1929.     A pointer to a zero-terminated string which contains the name of the object 
  1930.     class being replaced by pNewClassName in the workplace. 
  1931.  
  1932.  
  1933. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass Parameter - pNewClassName ΓòÉΓòÉΓòÉ
  1934.  
  1935.  pNewClassName (PSZ) - input 
  1936.     Pointer to new class name. 
  1937.  
  1938.     A pointer to a zero-terminated string which contains the name of the object 
  1939.     class replacing the pOldClassName class. 
  1940.  
  1941.  
  1942. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass Parameter - fReplace ΓòÉΓòÉΓòÉ
  1943.  
  1944.  fReplace (BOOL) - input 
  1945.     Function replacement flag. 
  1946.  
  1947.       TRUE 
  1948.          Replace the function of class pOldClassName with the function of the 
  1949.          class pNewClassName. 
  1950.  
  1951.       FALSE 
  1952.          Undo the replacement of the pOldClassName with pNewClassName by 
  1953.          restoring the pOldClassName back to its original functionality. 
  1954.  
  1955.  
  1956. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass Return Value - rc ΓòÉΓòÉΓòÉ
  1957.  
  1958.  rc (BOOL) - returns 
  1959.     Success indicator. 
  1960.  
  1961.       TRUE 
  1962.          Successful completion 
  1963.       FALSE 
  1964.          Error occurred. 
  1965.  
  1966.  
  1967. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass - Parameters ΓòÉΓòÉΓòÉ
  1968.  
  1969.  pOldClassName (PSZ) - input 
  1970.     Pointer to class name. 
  1971.  
  1972.     A pointer to a zero-terminated string which contains the name of the object 
  1973.     class being replaced by pNewClassName in the workplace. 
  1974.  
  1975.  pNewClassName (PSZ) - input 
  1976.     Pointer to new class name. 
  1977.  
  1978.     A pointer to a zero-terminated string which contains the name of the object 
  1979.     class replacing the pOldClassName class. 
  1980.  
  1981.  fReplace (BOOL) - input 
  1982.     Function replacement flag. 
  1983.  
  1984.       TRUE 
  1985.          Replace the function of class pOldClassName with the function of the 
  1986.          class pNewClassName. 
  1987.  
  1988.       FALSE 
  1989.          Undo the replacement of the pOldClassName with pNewClassName by 
  1990.          restoring the pOldClassName back to its original functionality. 
  1991.  
  1992.  rc (BOOL) - returns 
  1993.     Success indicator. 
  1994.  
  1995.       TRUE 
  1996.          Successful completion 
  1997.       FALSE 
  1998.          Error occurred. 
  1999.  
  2000.  
  2001. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass - Remarks ΓòÉΓòÉΓòÉ
  2002.  
  2003. The class specified by pNewClassName must be a descendant of the class 
  2004. specified by pOldClassName, otherwise an error will be returned.  Replacing an 
  2005. object is useful if it is desired to modify the behavior of objects which are 
  2006. instances of the class pOldClassName and which are not aware of the class 
  2007. pNewClassName. 
  2008.  
  2009.  
  2010. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass - Related Functions ΓòÉΓòÉΓòÉ
  2011.  
  2012.    o  WinCreateObject 
  2013.    o  WinDeregisterObjectClass 
  2014.    o  WinRegisterObjectClass 
  2015.  
  2016.  
  2017. ΓòÉΓòÉΓòÉ <hidden> WinReplaceObjectClass - Topics ΓòÉΓòÉΓòÉ
  2018.  
  2019. Select an item: 
  2020.  
  2021. Syntax
  2022. Parameters
  2023. Returns
  2024. Remarks
  2025. Related Functions
  2026. Glossary
  2027.  
  2028.  
  2029. ΓòÉΓòÉΓòÉ 1.18. WinRestartSOMDD ΓòÉΓòÉΓòÉ
  2030.  
  2031.  
  2032. ΓòÉΓòÉΓòÉ <hidden> WinRestartSOMDD - Syntax ΓòÉΓòÉΓòÉ
  2033.  
  2034. /*******************************************/
  2035. /* This function starts the DSOM daemon.   */
  2036. /*******************************************/
  2037.  
  2038. #define INCL_WPCLASS
  2039. #include <os2.h>
  2040.  
  2041. BOOL      fAction;  /*  Flag indicating action to perform on the DSOM daemon. */
  2042. APIRET    rc;       /*  Return code. */
  2043.  
  2044. rc = WinRestartSOMDD(fAction);
  2045.  
  2046.  
  2047. ΓòÉΓòÉΓòÉ <hidden> WinRestartSOMDD Parameter - fAction ΓòÉΓòÉΓòÉ
  2048.  
  2049.  fAction (BOOL) - input 
  2050.     Flag indicating action to perform on the DSOM daemon. 
  2051.  
  2052.       TRUE 
  2053.          Start the DSOM daemon. 
  2054.       FALSE 
  2055.          Stop the DSOM daemon. 
  2056.  
  2057.  
  2058. ΓòÉΓòÉΓòÉ <hidden> WinRestartSOMDD Return Value - rc ΓòÉΓòÉΓòÉ
  2059.  
  2060.  rc (APIRET) - returns 
  2061.     Return code. 
  2062.  
  2063.       PMERR_OK (0x0000) 
  2064.          Successfully invoked. 
  2065.  
  2066.       PMERR_WPDSERVER_IS_ACTIVE (0x1056) 
  2067.          The Workplace Shell DSOM Server is active and running. It cannot stop 
  2068.          the DSOM daemon until the Workplace Shell DSOM Server has stopped. 
  2069.  
  2070.       PMERR_SOMDD_IS_ACTIVE (0x1058) 
  2071.          The DSOM daemon has been started by the Workplace Shell process and is 
  2072.          active and running; therefore, it cannot be started again. 
  2073.  
  2074.       PMERR_SOMDD_NOT_STARTED (0x1059) 
  2075.          The DSOM daemon failed to start. It might be active in another 
  2076.          process. 
  2077.  
  2078.  
  2079. ΓòÉΓòÉΓòÉ <hidden> WinRestartSOMDD - Parameters ΓòÉΓòÉΓòÉ
  2080.  
  2081.  fAction (BOOL) - input 
  2082.     Flag indicating action to perform on the DSOM daemon. 
  2083.  
  2084.       TRUE 
  2085.          Start the DSOM daemon. 
  2086.       FALSE 
  2087.          Stop the DSOM daemon. 
  2088.  
  2089.  rc (APIRET) - returns 
  2090.     Return code. 
  2091.  
  2092.       PMERR_OK (0x0000) 
  2093.          Successfully invoked. 
  2094.  
  2095.       PMERR_WPDSERVER_IS_ACTIVE (0x1056) 
  2096.          The Workplace Shell DSOM Server is active and running. It cannot stop 
  2097.          the DSOM daemon until the Workplace Shell DSOM Server has stopped. 
  2098.  
  2099.       PMERR_SOMDD_IS_ACTIVE (0x1058) 
  2100.          The DSOM daemon has been started by the Workplace Shell process and is 
  2101.          active and running; therefore, it cannot be started again. 
  2102.  
  2103.       PMERR_SOMDD_NOT_STARTED (0x1059) 
  2104.          The DSOM daemon failed to start. It might be active in another 
  2105.          process. 
  2106.  
  2107.  
  2108. ΓòÉΓòÉΓòÉ <hidden> WinRestartSOMDD - Remarks ΓòÉΓòÉΓòÉ
  2109.  
  2110. This function starts the DSOM daemon in the Workplace Shell process as a 
  2111. background process invisible to the users. The status of the daemon can be 
  2112. determined at any time by calling WinIsSOMDDReady. 
  2113.  
  2114. Note:  This function requires that the PM Shell is up and running. 
  2115.  
  2116.  
  2117. ΓòÉΓòÉΓòÉ <hidden> WinRestartSOMDD - Related Functions ΓòÉΓòÉΓòÉ
  2118.  
  2119.    o  WinIsSOMDDReady 
  2120.    o  WinIsWPDServerReady 
  2121.    o  WinRestartWPDServer 
  2122.  
  2123.  
  2124. ΓòÉΓòÉΓòÉ <hidden> WinRestartSOMDD - Example Code ΓòÉΓòÉΓòÉ
  2125.  
  2126. This example starts the DSOM daemon within the Workplace Shell process. 
  2127.  
  2128. #define  INCL_WPCLASS
  2129. #include <os2.h>
  2130.  
  2131. enum   {ON, OFF};
  2132. APIRET apiRtnCd;
  2133.  
  2134. apiRtnCd = WinRestartSOMDD(ON);
  2135. if (apiRtnCd == PMERR_SOMDD_NOT_STARTED)
  2136.    somPrintf ("DSOM Daemon failed to start; might be active already");
  2137.  
  2138.  
  2139. ΓòÉΓòÉΓòÉ <hidden> WinRestartSOMDD - Topics ΓòÉΓòÉΓòÉ
  2140.  
  2141. Select an item: 
  2142.  
  2143. Syntax
  2144. Parameters
  2145. Returns
  2146. Remarks
  2147. Example Code
  2148. Related Functions
  2149. Glossary
  2150.  
  2151.  
  2152. ΓòÉΓòÉΓòÉ 1.19. WinRestartWPDServer ΓòÉΓòÉΓòÉ
  2153.  
  2154.  
  2155. ΓòÉΓòÉΓòÉ <hidden> WinRestartWPDServer - Syntax ΓòÉΓòÉΓòÉ
  2156.  
  2157. /*******************************************/
  2158. /* This function starts the Workplace      */
  2159. /* Shell DSOM server.                      */
  2160. /*******************************************/
  2161.  
  2162. #define INCL_WPCLASS
  2163. #include <os2.h>
  2164.  
  2165. BOOL      fAction;  /*  Flag indicating the action to perform on the Workplace Shell DSOM server. */
  2166. APIRET    rc;       /*  Return code. */
  2167.  
  2168. rc = WinRestartWPDServer(fAction);
  2169.  
  2170.  
  2171. ΓòÉΓòÉΓòÉ <hidden> WinRestartWPDServer Parameter - fAction ΓòÉΓòÉΓòÉ
  2172.  
  2173.  fAction (BOOL) - input 
  2174.     Flag indicating the action to perform on the Workplace Shell DSOM server. 
  2175.  
  2176.       TRUE 
  2177.          Start the Workplace Shell DSOM server. 
  2178.       FALSE 
  2179.          Stop the Workplace Shell DSOM server. 
  2180.  
  2181.  
  2182. ΓòÉΓòÉΓòÉ <hidden> WinRestartWPDServer Return Value - rc ΓòÉΓòÉΓòÉ
  2183.  
  2184.  rc (APIRET) - returns 
  2185.     Return code. 
  2186.  
  2187.       PMERR_OK (0x0000) 
  2188.          Successfully invoked. 
  2189.  
  2190.       PMERR_WPDSERVER_IS_ACTIVE (0x1056) 
  2191.          The Workplace Shell DSOM server is active and cannot be started again. 
  2192.  
  2193.       PMERR_WPDSERVER_NOT_STARTED (0x1057) 
  2194.          The Workplace Shell DSOM server could not be started, possibly related 
  2195.          to a corrupted copy of WPDSRVP.DLL. 
  2196.  
  2197.       Other 
  2198.          Any other non-zero value could indicate that the WPDSRVP.DLL is 
  2199.          corrupted or not found. 
  2200.  
  2201.  
  2202. ΓòÉΓòÉΓòÉ <hidden> WinRestartWPDServer - Parameters ΓòÉΓòÉΓòÉ
  2203.  
  2204.  fAction (BOOL) - input 
  2205.     Flag indicating the action to perform on the Workplace Shell DSOM server. 
  2206.  
  2207.       TRUE 
  2208.          Start the Workplace Shell DSOM server. 
  2209.       FALSE 
  2210.          Stop the Workplace Shell DSOM server. 
  2211.  
  2212.  rc (APIRET) - returns 
  2213.     Return code. 
  2214.  
  2215.       PMERR_OK (0x0000) 
  2216.          Successfully invoked. 
  2217.  
  2218.       PMERR_WPDSERVER_IS_ACTIVE (0x1056) 
  2219.          The Workplace Shell DSOM server is active and cannot be started again. 
  2220.  
  2221.       PMERR_WPDSERVER_NOT_STARTED (0x1057) 
  2222.          The Workplace Shell DSOM server could not be started, possibly related 
  2223.          to a corrupted copy of WPDSRVP.DLL. 
  2224.  
  2225.       Other 
  2226.          Any other non-zero value could indicate that the WPDSRVP.DLL is 
  2227.          corrupted or not found. 
  2228.  
  2229.  
  2230. ΓòÉΓòÉΓòÉ <hidden> WinRestartWPDServer - Remarks ΓòÉΓòÉΓòÉ
  2231.  
  2232. This function requires that the DSOM daemon is started first and must be 
  2233. running successfully in order for the Workplace Shell DSOM server to become 
  2234. ready. The status of the Workplace Shell DSOM server can be obtained at any 
  2235. time using WinIsWPDServerReady. Once the DSOM server is ready, a client 
  2236. Workplace Shell DSOM server application can be executed. 
  2237.  
  2238. Note:  This function requires that the PM Shell is up and running. 
  2239.  
  2240.  
  2241. ΓòÉΓòÉΓòÉ <hidden> WinRestartWPDServer - Related Functions ΓòÉΓòÉΓòÉ
  2242.  
  2243.    o  WinIsSOMDDReady 
  2244.    o  WinIsWPDServerReady 
  2245.    o  WinRestartSOMDD 
  2246.  
  2247.  
  2248. ΓòÉΓòÉΓòÉ <hidden> WinRestartWPDServer - Example Code ΓòÉΓòÉΓòÉ
  2249.  
  2250. This example starts the DSOM daemon within the Workplace Shell process and then 
  2251. starts the Workplace Shell DSOM server. 
  2252.  
  2253. #define  INCL_WINERRORS
  2254. #define  INCL_WPCLASS
  2255. #include <os2.h>
  2256.  
  2257. enum     {ON,OFF};
  2258. APIRET   apiRtnCd;
  2259.  
  2260. apiRtnCd=WinRestartSOMDD(ON);
  2261. if (apiRtnCd == PMERR_OK)
  2262. {
  2263.   apiRtnCd = WinRestartWPDServer(ON);
  2264.   if (apiRtnCd)
  2265.   {
  2266.     PERRINFO perriErrorInfo;
  2267.  
  2268.     if (apiRtnCd == PMERR_WPDSERVER_IS_ACTIVE)
  2269.     {
  2270.       somPrintf("The Workplace Shell DSOM server is already running");
  2271.       exit(2);
  2272.     }
  2273.     if (apiRtnCd == PMERR_WPDSERVER_NOT_STARTED)
  2274.     {
  2275.       somPrintf("Failed to start the Workplace Shell DSOM server");
  2276.       exit(2);
  2277.     }
  2278.  
  2279.     /* Obtain the error block                                   */
  2280.     /* WinGetErrorInfo is for DosLoadModule related errors only */
  2281.     perriErrorInfo = WinGetErrorInfo(hab);
  2282.     somPrintf("Loading WPDSRVP.DLL failed: %ld", perriErrorInfo->idError);
  2283.     WinFreeErrorInfo(perriErrorInfo);
  2284.     exit(99);
  2285.   }
  2286.   somPrintf("All's well!");
  2287. }
  2288. else
  2289. {
  2290.   somPrintf("Failed to start the DSOM daemon");
  2291.   exit(1);
  2292. }
  2293.  
  2294.  
  2295. ΓòÉΓòÉΓòÉ <hidden> WinRestartWPDServer - Topics ΓòÉΓòÉΓòÉ
  2296.  
  2297. Select an item: 
  2298.  
  2299. Syntax
  2300. Parameters
  2301. Returns
  2302. Remarks
  2303. Example Code
  2304. Related Functions
  2305. Glossary
  2306.  
  2307.  
  2308. ΓòÉΓòÉΓòÉ 1.20. WinRestoreWindowPos ΓòÉΓòÉΓòÉ
  2309.  
  2310.  
  2311. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos - Syntax ΓòÉΓòÉΓòÉ
  2312.  
  2313. /*******************************************/
  2314. /* The WinRestoreWindowPos function will   */
  2315. /* restore the size and position of the    */
  2316. /* window specified by hwnd to the state   */
  2317. /* it was in when WinStoreWindowPos was    */
  2318. /* last called with the same pAppName and  */
  2319. /* pKeyName.                               */
  2320. /*******************************************/
  2321.  
  2322. #define INCL_WINWORKPLACE
  2323. #include <os2.h>
  2324.  
  2325. PSZ     pAppName;  /*  Pointer to application name. */
  2326. PSZ     pKeyName;  /*  Pointer to key name. */
  2327. HWND    hwnd;      /*  Window handle of the window to restore. */
  2328. BOOL    rc;        /*  Success indicator. */
  2329.  
  2330. rc = WinRestoreWindowPos(pAppName, pKeyName,
  2331.        hwnd);
  2332.  
  2333.  
  2334. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos Parameter - pAppName ΓòÉΓòÉΓòÉ
  2335.  
  2336.  pAppName (PSZ) - input 
  2337.     Pointer to application name. 
  2338.  
  2339.     A pointer to a zero-terminated string which contains the application name. 
  2340.  
  2341.  
  2342. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos Parameter - pKeyName ΓòÉΓòÉΓòÉ
  2343.  
  2344.  pKeyName (PSZ) - input 
  2345.     Pointer to key name. 
  2346.  
  2347.     A pointer to a zero-terminated string which contains the key name. 
  2348.  
  2349.  
  2350. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos Parameter - hwnd ΓòÉΓòÉΓòÉ
  2351.  
  2352.  hwnd (HWND) - input 
  2353.     Window handle of the window to restore. 
  2354.  
  2355.  
  2356. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos Return Value - rc ΓòÉΓòÉΓòÉ
  2357.  
  2358.  rc (BOOL) - returns 
  2359.     Success indicator. 
  2360.  
  2361.       TRUE 
  2362.          Successful completion 
  2363.       FALSE 
  2364.          Error occurred. 
  2365.  
  2366.  
  2367. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos - Parameters ΓòÉΓòÉΓòÉ
  2368.  
  2369.  pAppName (PSZ) - input 
  2370.     Pointer to application name. 
  2371.  
  2372.     A pointer to a zero-terminated string which contains the application name. 
  2373.  
  2374.  pKeyName (PSZ) - input 
  2375.     Pointer to key name. 
  2376.  
  2377.     A pointer to a zero-terminated string which contains the key name. 
  2378.  
  2379.  hwnd (HWND) - input 
  2380.     Window handle of the window to restore. 
  2381.  
  2382.  rc (BOOL) - returns 
  2383.     Success indicator. 
  2384.  
  2385.       TRUE 
  2386.          Successful completion 
  2387.       FALSE 
  2388.          Error occurred. 
  2389.  
  2390.  
  2391. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos - Remarks ΓòÉΓòÉΓòÉ
  2392.  
  2393. This function will also restore presentation parameters which were saved by a 
  2394. previous call to WinStoreWindowPos. 
  2395.  
  2396.  
  2397. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos - Related Functions ΓòÉΓòÉΓòÉ
  2398.  
  2399.    o  WinStoreWindowPos 
  2400.  
  2401.  
  2402. ΓòÉΓòÉΓòÉ <hidden> WinRestoreWindowPos - Topics ΓòÉΓòÉΓòÉ
  2403.  
  2404. Select an item: 
  2405.  
  2406. Syntax
  2407. Parameters
  2408. Returns
  2409. Remarks
  2410. Related Functions
  2411. Glossary
  2412.  
  2413.  
  2414. ΓòÉΓòÉΓòÉ 1.21. WinSaveObject ΓòÉΓòÉΓòÉ
  2415.  
  2416.  
  2417. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject - Syntax ΓòÉΓòÉΓòÉ
  2418.  
  2419. /*******************************************/
  2420. /* This function is specific to version 3, */
  2421. /* or higher, of the OS/2 operating        */
  2422. /* system.  This function saves the state  */
  2423. /* of an object.                           */
  2424. /*******************************************/
  2425.  
  2426. #define INCL_WINWORKPLACE
  2427. #include <os2.h>
  2428.  
  2429. HOBJECT    hObject;  /*  Handle of the object to be saved. */
  2430. BOOL       fAsync;   /*  Asynchronous flag. */
  2431. BOOL       rc;       /*  Success indicator. */
  2432.  
  2433. rc = WinSaveObject(hObject, fAsync);
  2434.  
  2435.  
  2436. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject Parameter - hObject ΓòÉΓòÉΓòÉ
  2437.  
  2438.  hObject (HOBJECT) - input 
  2439.     Handle of the object to be saved. 
  2440.  
  2441.  
  2442. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject Parameter - fAsync ΓòÉΓòÉΓòÉ
  2443.  
  2444.  fAsync (BOOL) - input 
  2445.     Asynchronous flag. 
  2446.  
  2447.       TRUE 
  2448.          Calls asynchronous save. 
  2449.       FALSE 
  2450.          Calls synchronous save. 
  2451.  
  2452.  
  2453. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject Return Value - rc ΓòÉΓòÉΓòÉ
  2454.  
  2455.  rc (BOOL) - returns 
  2456.     Success indicator. 
  2457.  
  2458.       TRUE 
  2459.          Successful completion 
  2460.       FALSE 
  2461.          Error occurred. 
  2462.  
  2463.  
  2464. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject - Parameters ΓòÉΓòÉΓòÉ
  2465.  
  2466.  hObject (HOBJECT) - input 
  2467.     Handle of the object to be saved. 
  2468.  
  2469.  fAsync (BOOL) - input 
  2470.     Asynchronous flag. 
  2471.  
  2472.       TRUE 
  2473.          Calls asynchronous save. 
  2474.       FALSE 
  2475.          Calls synchronous save. 
  2476.  
  2477.  rc (BOOL) - returns 
  2478.     Success indicator. 
  2479.  
  2480.       TRUE 
  2481.          Successful completion 
  2482.       FALSE 
  2483.          Error occurred. 
  2484.  
  2485.  
  2486. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject - Remarks ΓòÉΓòÉΓòÉ
  2487.  
  2488. If an asynchronous save is called, the object will be saved on a separate 
  2489. thread ("lazy written"); this is the preferred method for saving.  Otherwise, 
  2490. the object is saved on the user interface thread. 
  2491.  
  2492. Using HOBJECT for .INI files or files in which an application uses a 
  2493. rename/save/delete sequence is not supported. 
  2494.  
  2495.  
  2496. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject - Related Functions ΓòÉΓòÉΓòÉ
  2497.  
  2498.    o  WinCopyObject 
  2499.    o  WinCreateObject. 
  2500.    o  WinDestroyObject 
  2501.    o  WinMoveObject 
  2502.    o  WinQueryObjectWindow 
  2503.  
  2504.  
  2505. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject - Example Code ΓòÉΓòÉΓòÉ
  2506.  
  2507. #define INCL_WINWORKPLACE
  2508. #include "os2.h"
  2509.  
  2510. HOBJECT  Object;
  2511. BOOL     fAsync = TRUE;
  2512. BOOL     fSuccess
  2513.  
  2514. hObject = WinQueryObject("<WP_DESKTOP>");
  2515. if (hObject != NULL)
  2516.   {
  2517.     /* WinQueryObject was successful */
  2518.  
  2519.     fSuccess = WinSaveObject(hObject,fAsync);
  2520.     if (fSuccess)
  2521.   {
  2522.     /* The state of the Desktop was saved Asynchronously */
  2523.   }
  2524. else
  2525.   {
  2526.     /* Asynchronous save of the Desktop failed */
  2527.   }
  2528.  
  2529.  
  2530. ΓòÉΓòÉΓòÉ <hidden> WinSaveObject - Topics ΓòÉΓòÉΓòÉ
  2531.  
  2532. Select an item: 
  2533.  
  2534. Syntax
  2535. Parameters
  2536. Returns
  2537. Remarks
  2538. Example Code
  2539. Related Functions
  2540. Glossary
  2541.  
  2542.  
  2543. ΓòÉΓòÉΓòÉ 1.22. WinSetFileIcon ΓòÉΓòÉΓòÉ
  2544.  
  2545.  
  2546. ΓòÉΓòÉΓòÉ <hidden> WinSetFileIcon - Syntax ΓòÉΓòÉΓòÉ
  2547.  
  2548. /*******************************************/
  2549. /* WinSetFileIcon sets the icon for the    */
  2550. /* file specified by pFileName to the icon */
  2551. /* specified by picon.                     */
  2552. /*******************************************/
  2553.  
  2554. #define INCL_WINPOINTERS
  2555. #include <os2.h>
  2556.  
  2557. PSZ          pFileName;  /*  Pointer to file name. */
  2558. PICONINFO    picon;      /*  A pointer to an ICONINFO structure containing an icon specification. */
  2559. BOOL         rc;         /*  Success indicator. */
  2560.  
  2561. rc = WinSetFileIcon(pFileName, picon);
  2562.  
  2563.  
  2564. ΓòÉΓòÉΓòÉ <hidden> WinSetFileIcon Parameter - pFileName ΓòÉΓòÉΓòÉ
  2565.  
  2566.  pFileName (PSZ) - input 
  2567.     Pointer to file name. 
  2568.  
  2569.     A pointer to a zero-terminated string which contains the name of the file 
  2570.     whose icon will be set. 
  2571.  
  2572.  
  2573. ΓòÉΓòÉΓòÉ <hidden> WinSetFileIcon Parameter - picon ΓòÉΓòÉΓòÉ
  2574.  
  2575.  picon (PICONINFO) - input 
  2576.     A pointer to an ICONINFO structure containing an icon specification. 
  2577.  
  2578.  
  2579. ΓòÉΓòÉΓòÉ <hidden> WinSetFileIcon Return Value - rc ΓòÉΓòÉΓòÉ
  2580.  
  2581.  rc (BOOL) - returns 
  2582.     Success indicator. 
  2583.  
  2584.       TRUE 
  2585.          Successful completion 
  2586.       FALSE 
  2587.          Error occurred. 
  2588.  
  2589.  
  2590. ΓòÉΓòÉΓòÉ <hidden> WinSetFileIcon - Parameters ΓòÉΓòÉΓòÉ
  2591.  
  2592.  pFileName (PSZ) - input 
  2593.     Pointer to file name. 
  2594.  
  2595.     A pointer to a zero-terminated string which contains the name of the file 
  2596.     whose icon will be set. 
  2597.  
  2598.  picon (PICONINFO) - input 
  2599.     A pointer to an ICONINFO structure containing an icon specification. 
  2600.  
  2601.  rc (BOOL) - returns 
  2602.     Success indicator. 
  2603.  
  2604.       TRUE 
  2605.          Successful completion 
  2606.       FALSE 
  2607.          Error occurred. 
  2608.  
  2609.  
  2610. ΓòÉΓòÉΓòÉ <hidden> WinSetFileIcon - Remarks ΓòÉΓòÉΓòÉ
  2611.  
  2612. The specified icon is written to the file's .ICON extended attribute. 
  2613.  
  2614.  
  2615. ΓòÉΓòÉΓòÉ <hidden> WinSetFileIcon - Related Functions ΓòÉΓòÉΓòÉ
  2616.  
  2617.    o  WinLoadFileIcon 
  2618.    o  WinFreeFileIcon 
  2619.  
  2620.  
  2621. ΓòÉΓòÉΓòÉ <hidden> WinSetFileIcon - Topics ΓòÉΓòÉΓòÉ
  2622.  
  2623. Select an item: 
  2624.  
  2625. Syntax
  2626. Parameters
  2627. Returns
  2628. Remarks
  2629. Related Functions
  2630. Glossary
  2631.  
  2632.  
  2633. ΓòÉΓòÉΓòÉ 1.23. WinSetObjectData ΓòÉΓòÉΓòÉ
  2634.  
  2635.  
  2636. ΓòÉΓòÉΓòÉ <hidden> WinSetObjectData - Syntax ΓòÉΓòÉΓòÉ
  2637.  
  2638. /*******************************************/
  2639. /* The WinSetObjectData function is called */
  2640. /* to set data on a workplace object.      */
  2641. /*******************************************/
  2642.  
  2643. #define INCL_WINWORKPLACE
  2644. #include <os2.h>
  2645.  
  2646. HOBJECT    object;        /*  Handle to a workplace object. */
  2647. PSZ        pSetupString;  /*  Pointer to object-specific parameters. */
  2648. BOOL       rc;            /*  Success indicator. */
  2649.  
  2650. rc = WinSetObjectData(object, pSetupString);
  2651.  
  2652.  
  2653. ΓòÉΓòÉΓòÉ <hidden> WinSetObjectData Parameter - object ΓòÉΓòÉΓòÉ
  2654.  
  2655.  object (HOBJECT) - input 
  2656.     Handle to a workplace object. 
  2657.  
  2658.  
  2659. ΓòÉΓòÉΓòÉ <hidden> WinSetObjectData Parameter - pSetupString ΓòÉΓòÉΓòÉ
  2660.  
  2661.  pSetupString (PSZ) - input 
  2662.     Pointer to object-specific parameters. 
  2663.  
  2664.     A pointer to a zero-terminated string which contains the object-specific 
  2665.     parameters to the new object. 
  2666.  
  2667.     The pSetupString string is extracted when the wpSetup method is called. For 
  2668.     a listing of setup strings, see individual object classes; See WPLaunchPad 
  2669.     class definition for a discussion of setup string values used in Launch Pad 
  2670.     customization. 
  2671.  
  2672.  
  2673. ΓòÉΓòÉΓòÉ <hidden> WinSetObjectData Return Value - rc ΓòÉΓòÉΓòÉ
  2674.  
  2675.  rc (BOOL) - returns 
  2676.     Success indicator. 
  2677.  
  2678.       TRUE 
  2679.          Successful completion. 
  2680.       FALSE 
  2681.          Error occurred. 
  2682.  
  2683.  
  2684. ΓòÉΓòÉΓòÉ <hidden> WinSetObjectData - Parameters ΓòÉΓòÉΓòÉ
  2685.  
  2686.  object (HOBJECT) - input 
  2687.     Handle to a workplace object. 
  2688.  
  2689.  pSetupString (PSZ) - input 
  2690.     Pointer to object-specific parameters. 
  2691.  
  2692.     A pointer to a zero-terminated string which contains the object-specific 
  2693.     parameters to the new object. 
  2694.  
  2695.     The pSetupString string is extracted when the wpSetup method is called. For 
  2696.     a listing of setup strings, see individual object classes; See WPLaunchPad 
  2697.     class definition for a discussion of setup string values used in Launch Pad 
  2698.     customization. 
  2699.  
  2700.  rc (BOOL) - returns 
  2701.     Success indicator. 
  2702.  
  2703.       TRUE 
  2704.          Successful completion. 
  2705.       FALSE 
  2706.          Error occurred. 
  2707.  
  2708.  
  2709. ΓòÉΓòÉΓòÉ <hidden> WinSetObjectData - Remarks ΓòÉΓòÉΓòÉ
  2710.  
  2711. The WinSetObjectData function will change settings on an object that was 
  2712. created with the WinCreateObject function. 
  2713.  
  2714. Using HOBJECT for .INI files or files in which an application uses a 
  2715. rename/save/delete sequence is not supported. 
  2716.  
  2717.  
  2718. ΓòÉΓòÉΓòÉ <hidden> WinSetObjectData - Related Functions ΓòÉΓòÉΓòÉ
  2719.  
  2720.    o  WinCreateObject 
  2721.    o  WinSetObjectData 
  2722.    o  WinDestroyObject 
  2723.  
  2724.  
  2725. ΓòÉΓòÉΓòÉ <hidden> WinSetObjectData - Topics ΓòÉΓòÉΓòÉ
  2726.  
  2727. Select an item: 
  2728.  
  2729. Syntax
  2730. Parameters
  2731. Returns
  2732. Remarks
  2733. Related Functions
  2734. Glossary
  2735.  
  2736.  
  2737. ΓòÉΓòÉΓòÉ 1.24. WinShutdownSystem ΓòÉΓòÉΓòÉ
  2738.  
  2739.  
  2740. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem - Syntax ΓòÉΓòÉΓòÉ
  2741.  
  2742. /*******************************************/
  2743. /* The WinShutdownSystem function will     */
  2744. /* close down the system.                  */
  2745. /*******************************************/
  2746.  
  2747. #define INCL_WINWORKPLACE
  2748. #include <os2.h>
  2749.  
  2750. HAB     hab;  /*  Anchor-block handle. */
  2751. HMQ     hmq;  /*  Message-queue handle. */
  2752. BOOL    rc;   /*  Success indicator. */
  2753.  
  2754. rc = WinShutdownSystem(hab, hmq);
  2755.  
  2756.  
  2757. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem Parameter - hab ΓòÉΓòÉΓòÉ
  2758.  
  2759.  hab (HAB) - input 
  2760.     Anchor-block handle. 
  2761.  
  2762.  
  2763. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem Parameter - hmq ΓòÉΓòÉΓòÉ
  2764.  
  2765.  hmq (HMQ) - input 
  2766.     Message-queue handle. 
  2767.  
  2768.  
  2769. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem Return Value - rc ΓòÉΓòÉΓòÉ
  2770.  
  2771.  rc (BOOL) - returns 
  2772.     Success indicator. 
  2773.  
  2774.       TRUE 
  2775.          Successful completion 
  2776.       FALSE 
  2777.          Error occurred. 
  2778.  
  2779.  
  2780. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem - Parameters ΓòÉΓòÉΓòÉ
  2781.  
  2782.  hab (HAB) - input 
  2783.     Anchor-block handle. 
  2784.  
  2785.  hmq (HMQ) - input 
  2786.     Message-queue handle. 
  2787.  
  2788.  rc (BOOL) - returns 
  2789.     Success indicator. 
  2790.  
  2791.       TRUE 
  2792.          Successful completion 
  2793.       FALSE 
  2794.          Error occurred. 
  2795.  
  2796.  
  2797. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem - Remarks ΓòÉΓòÉΓòÉ
  2798.  
  2799. The WinShutdownSystem function will close all running applications and will 
  2800. then call DosShutdown. 
  2801.  
  2802. Presentation Manager applications will receive a WM_SAVEAPPLICATION message 
  2803. prior to a WM_QUIT message. 
  2804.  
  2805. When the system is restarted, all applications that were running when 
  2806. WinShutdownSystem was last called will be restarted. 
  2807.  
  2808.  
  2809. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem - Related Functions ΓòÉΓòÉΓòÉ
  2810.  
  2811.    o  WinCancelShutdown 
  2812.  
  2813.  
  2814. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem - Example Code ΓòÉΓòÉΓòÉ
  2815.  
  2816. This example performs an OS/2 System Shutdown from a program. 
  2817.  
  2818.  #define INCL_WINWORKPLACE
  2819.  #define INCL_DOSFILEMGR
  2820.  #define INCL_DOSERRORS
  2821.  #include <os2.h>
  2822.  #include <stdio.h>
  2823.  
  2824.  int main(VOID)
  2825.    {
  2826.  
  2827.     HAB   hab      = NULLHANDLE;   /* Window handle */
  2828.     HMQ   hmq      = NULLHANDLE;   /* Message queue handle */
  2829.     BOOL  fSuccess = 0;            /* Win API success indicator */
  2830.  
  2831.     hab = WinInitialize( 0 );
  2832.     hmq = WinCreateMsgQueue( hab, 0 );
  2833.  
  2834.     /* Prevent our program from hanging the shutdown.  If this call is
  2835.        omitted, the system will wait for us to do a WinDestroyMsgQueue. */
  2836.  
  2837.     fSuccess = WinCancelShutdown( hmq, TRUE );
  2838.  
  2839.     /* Shutdown the system! */
  2840.  
  2841.     printf("System Shutdown will now be attempted...\n");
  2842.     fSuccess = WinShutdownSystem( hab, hmq );
  2843.  
  2844.     if (!fSuccess) {
  2845.        return 1;
  2846.     } else {
  2847.        return NO_ERROR;
  2848.     } /* endif */
  2849.  
  2850.     }
  2851.  
  2852.  
  2853. ΓòÉΓòÉΓòÉ <hidden> WinShutdownSystem - Topics ΓòÉΓòÉΓòÉ
  2854.  
  2855. Select an item: 
  2856.  
  2857. Syntax
  2858. Parameters
  2859. Returns
  2860. Remarks
  2861. Example Code
  2862. Related Functions
  2863. Glossary
  2864.  
  2865.  
  2866. ΓòÉΓòÉΓòÉ 1.25. WinStoreWindowPos ΓòÉΓòÉΓòÉ
  2867.  
  2868.  
  2869. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos - Syntax ΓòÉΓòÉΓòÉ
  2870.  
  2871. /*******************************************/
  2872. /* The WinStoreWindowPos function will     */
  2873. /* save the current size and position of   */
  2874. /* the window specified by hwnd.           */
  2875. /*******************************************/
  2876.  
  2877. #define INCL_WINWORKPLACE
  2878. #include <os2.h>
  2879.  
  2880. PSZ     pAppName;  /*  Pointer to application name. */
  2881. PSZ     pKeyName;  /*  Pointer to key name. */
  2882. HWND    hwnd;      /*  Window handle for the window to be stored. */
  2883. BOOL    rc;        /*  Success indicator. */
  2884.  
  2885. rc = WinStoreWindowPos(pAppName, pKeyName,
  2886.        hwnd);
  2887.  
  2888.  
  2889. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos Parameter - pAppName ΓòÉΓòÉΓòÉ
  2890.  
  2891.  pAppName (PSZ) - input 
  2892.     Pointer to application name. 
  2893.  
  2894.     A pointer to a zero-terminated string which contains the application name. 
  2895.  
  2896.  
  2897. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos Parameter - pKeyName ΓòÉΓòÉΓòÉ
  2898.  
  2899.  pKeyName (PSZ) - input 
  2900.     Pointer to key name. 
  2901.  
  2902.     A pointer to a zero-terminated string which contains the key name. 
  2903.  
  2904.  
  2905. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos Parameter - hwnd ΓòÉΓòÉΓòÉ
  2906.  
  2907.  hwnd (HWND) - input 
  2908.     Window handle for the window to be stored. 
  2909.  
  2910.  
  2911. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos Return Value - rc ΓòÉΓòÉΓòÉ
  2912.  
  2913.  rc (BOOL) - returns 
  2914.     Success indicator. 
  2915.  
  2916.       TRUE 
  2917.          Successful completion 
  2918.       FALSE 
  2919.          Error occurred. 
  2920.  
  2921.  
  2922. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos - Parameters ΓòÉΓòÉΓòÉ
  2923.  
  2924.  pAppName (PSZ) - input 
  2925.     Pointer to application name. 
  2926.  
  2927.     A pointer to a zero-terminated string which contains the application name. 
  2928.  
  2929.  pKeyName (PSZ) - input 
  2930.     Pointer to key name. 
  2931.  
  2932.     A pointer to a zero-terminated string which contains the key name. 
  2933.  
  2934.  hwnd (HWND) - input 
  2935.     Window handle for the window to be stored. 
  2936.  
  2937.  rc (BOOL) - returns 
  2938.     Success indicator. 
  2939.  
  2940.       TRUE 
  2941.          Successful completion 
  2942.       FALSE 
  2943.          Error occurred. 
  2944.  
  2945.  
  2946. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos - Remarks ΓòÉΓòÉΓòÉ
  2947.  
  2948. This function will also save the presentation parameters. 
  2949.  
  2950.  
  2951. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos - Related Functions ΓòÉΓòÉΓòÉ
  2952.  
  2953.    o  WinRestoreWindowPos 
  2954.  
  2955.  
  2956. ΓòÉΓòÉΓòÉ <hidden> WinStoreWindowPos - Topics ΓòÉΓòÉΓòÉ
  2957.  
  2958. Select an item: 
  2959.  
  2960. Syntax
  2961. Parameters
  2962. Returns
  2963. Remarks
  2964. Related Functions
  2965. Glossary
  2966.  
  2967.  
  2968. ΓòÉΓòÉΓòÉ 2. Data Types ΓòÉΓòÉΓòÉ
  2969.  
  2970. The following data types are used in Workplace Shell. They are listed in 
  2971. alphabetic order. 
  2972.  
  2973.  
  2974. ΓòÉΓòÉΓòÉ 2.1. ACTIONS ΓòÉΓòÉΓòÉ
  2975.  
  2976. Action button data structure. 
  2977.  
  2978. typedef struct _ACTIONS {
  2979. PSZ     pszTitle;  /*  String containing the title of the action button. */
  2980. ULONG   ulMenuId;  /*  Desktop menu IDs. */
  2981.  } ACTIONS;
  2982.  
  2983. typedef ACTIONS *PACTIONS;
  2984.  
  2985.  
  2986. ΓòÉΓòÉΓòÉ <hidden> ACTIONS Parameter - pszTitle ΓòÉΓòÉΓòÉ
  2987.  
  2988.  pszTitle (PSZ) 
  2989.     String containing the title of the action button. 
  2990.  
  2991.  
  2992. ΓòÉΓòÉΓòÉ <hidden> ACTIONS Parameter - ulMenuId ΓòÉΓòÉΓòÉ
  2993.  
  2994.  ulMenuId (ULONG) 
  2995.     Desktop menu IDs. 
  2996.  
  2997.  
  2998. ΓòÉΓòÉΓòÉ 2.2. APIRET ΓòÉΓòÉΓòÉ
  2999.  
  3000. Unsigned integer in the range 0 through 4 294 967 295. 
  3001.  
  3002. typedef unsigned long APIRET;
  3003.  
  3004.  
  3005. ΓòÉΓòÉΓòÉ 2.3. BOOL ΓòÉΓòÉΓòÉ
  3006.  
  3007. Boolean. 
  3008.  
  3009. Valid values are FALSE, which is 0, and TRUE, which is 1. 
  3010.  
  3011. typedef unsigned long BOOL;
  3012.  
  3013.  
  3014. ΓòÉΓòÉΓòÉ 2.4. BYTE ΓòÉΓòÉΓòÉ
  3015.  
  3016. A byte. 
  3017.  
  3018. typedef unsigned char BYTE;
  3019.  
  3020.  
  3021. ΓòÉΓòÉΓòÉ 2.5. CDATE ΓòÉΓòÉΓòÉ
  3022.  
  3023. Structure that contains date information for a data element in the details view 
  3024. of a container control. 
  3025.  
  3026. typedef struct _CDATE {
  3027. UCHAR    day;    /*  Current day. */
  3028. UCHAR    month;  /*  Current month. */
  3029. USHORT   year;   /*  Current year. */
  3030.  } CDATE;
  3031.  
  3032. typedef CDATE *PCDATE;
  3033.  
  3034.  
  3035. ΓòÉΓòÉΓòÉ <hidden> CDATE Parameter - day ΓòÉΓòÉΓòÉ
  3036.  
  3037.  day (UCHAR) 
  3038.     Current day. 
  3039.  
  3040.  
  3041. ΓòÉΓòÉΓòÉ <hidden> CDATE Parameter - month ΓòÉΓòÉΓòÉ
  3042.  
  3043.  month (UCHAR) 
  3044.     Current month. 
  3045.  
  3046.  
  3047. ΓòÉΓòÉΓòÉ <hidden> CDATE Parameter - year ΓòÉΓòÉΓòÉ
  3048.  
  3049.  year (USHORT) 
  3050.     Current year. 
  3051.  
  3052.  
  3053. ΓòÉΓòÉΓòÉ 2.6. CELL ΓòÉΓòÉΓòÉ
  3054.  
  3055. Class-specific cell data follows immediately afterward. 
  3056.  
  3057. typedef struct _CELL {
  3058. ULONG   cbData;  /*  Size of the data that follows. */
  3059.  } CELL;
  3060.  
  3061. typedef CELL *PCELL;
  3062.  
  3063.  
  3064. ΓòÉΓòÉΓòÉ <hidden> CELL Parameter - cbData ΓòÉΓòÉΓòÉ
  3065.  
  3066.  cbData (ULONG) 
  3067.     Size of the data that follows. 
  3068.  
  3069.     Class-specific cell data follows immediately after a variable of this type. 
  3070.     For example the font palette would store the ASCII name of the font, and 
  3071.     the color palette would store the RGB color of the cell. 
  3072.  
  3073.  
  3074. ΓòÉΓòÉΓòÉ 2.7. CHAR ΓòÉΓòÉΓòÉ
  3075.  
  3076. Single-byte character. 
  3077.  
  3078. #define CHAR char
  3079.  
  3080.  
  3081. ΓòÉΓòÉΓòÉ 2.8. CHARBUNDLE ΓòÉΓòÉΓòÉ
  3082.  
  3083. Character-attributes bundle structure. 
  3084.  
  3085. typedef struct _CHARBUNDLE {
  3086. LONG     lColor;         /*  Character foreground color. */
  3087. LONG     lBackColor;     /*  Character background color. */
  3088. USHORT   usMixMode;      /*  Character foreground-mix mode. */
  3089. USHORT   usBackMixMode;  /*  Character background-mix mode. */
  3090. USHORT   usSet;          /*  Character set. */
  3091. USHORT   usPrecision;    /*  Character precision. */
  3092. SIZEF    sizfxCell;      /*  Character cell size. */
  3093. POINTL   ptlAngle;       /*  Character angle. */
  3094. POINTL   ptlShear;       /*  Character shear. */
  3095. USHORT   usDirection;    /*  Character direction. */
  3096. USHORT   usTextAlign;    /*  Text alignment. */
  3097. FIXED    fxExtra;        /*  Character extra. */
  3098. FIXED    fxBreakExtra;   /*  Character break extra. */
  3099.  } CHARBUNDLE;
  3100.  
  3101. typedef CHARBUNDLE *PCHARBUNDLE;
  3102.  
  3103.  
  3104. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - lColor ΓòÉΓòÉΓòÉ
  3105.  
  3106.  lColor (LONG) 
  3107.     Character foreground color. 
  3108.  
  3109.  
  3110. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - lBackColor ΓòÉΓòÉΓòÉ
  3111.  
  3112.  lBackColor (LONG) 
  3113.     Character background color. 
  3114.  
  3115.  
  3116. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - usMixMode ΓòÉΓòÉΓòÉ
  3117.  
  3118.  usMixMode (USHORT) 
  3119.     Character foreground-mix mode. 
  3120.  
  3121.  
  3122. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - usBackMixMode ΓòÉΓòÉΓòÉ
  3123.  
  3124.  usBackMixMode (USHORT) 
  3125.     Character background-mix mode. 
  3126.  
  3127.  
  3128. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - usSet ΓòÉΓòÉΓòÉ
  3129.  
  3130.  usSet (USHORT) 
  3131.     Character set. 
  3132.  
  3133.  
  3134. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - usPrecision ΓòÉΓòÉΓòÉ
  3135.  
  3136.  usPrecision (USHORT) 
  3137.     Character precision. 
  3138.  
  3139.  
  3140. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - sizfxCell ΓòÉΓòÉΓòÉ
  3141.  
  3142.  sizfxCell (SIZEF) 
  3143.     Character cell size. 
  3144.  
  3145.  
  3146. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - ptlAngle ΓòÉΓòÉΓòÉ
  3147.  
  3148.  ptlAngle (POINTL) 
  3149.     Character angle. 
  3150.  
  3151.  
  3152. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - ptlShear ΓòÉΓòÉΓòÉ
  3153.  
  3154.  ptlShear (POINTL) 
  3155.     Character shear. 
  3156.  
  3157.  
  3158. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - usDirection ΓòÉΓòÉΓòÉ
  3159.  
  3160.  usDirection (USHORT) 
  3161.     Character direction. 
  3162.  
  3163.  
  3164. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - usTextAlign ΓòÉΓòÉΓòÉ
  3165.  
  3166.  usTextAlign (USHORT) 
  3167.     Text alignment. 
  3168.  
  3169.  
  3170. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - fxExtra ΓòÉΓòÉΓòÉ
  3171.  
  3172.  fxExtra (FIXED) 
  3173.     Character extra. 
  3174.  
  3175.  
  3176. ΓòÉΓòÉΓòÉ <hidden> CHARBUNDLE Parameter - fxBreakExtra ΓòÉΓòÉΓòÉ
  3177.  
  3178.  fxBreakExtra (FIXED) 
  3179.     Character break extra. 
  3180.  
  3181.  
  3182. ΓòÉΓòÉΓòÉ 2.9. CLASS ΓòÉΓòÉΓòÉ
  3183.  
  3184. An array of class objects. The final element of the array should be NULL. 
  3185.  
  3186. typedef M_WPObject * CLASS;
  3187.  
  3188.  
  3189. ΓòÉΓòÉΓòÉ 2.10. CLASSDETAILS ΓòÉΓòÉΓòÉ
  3190.  
  3191. Class details data structure. 
  3192.  
  3193. typedef STRUCT _CLASSDETAILS {
  3194. PSZ     pszAttribute;  /*  Translatable string. */
  3195. PVOID   pSortRecord;   /*  Function pointer for the sort function for the attribute. */
  3196.  } CLASSDETAILS;
  3197.  
  3198. typedef CLASSDETAILS *PCLASSDETAILS;
  3199.  
  3200.  
  3201. ΓòÉΓòÉΓòÉ <hidden> CLASSDETAILS Parameter - pszAttribute ΓòÉΓòÉΓòÉ
  3202.  
  3203.  pszAttribute (PSZ) 
  3204.     Translatable string. 
  3205.  
  3206.     Translatable string for a class attribute. 
  3207.  
  3208.  
  3209. ΓòÉΓòÉΓòÉ <hidden> CLASSDETAILS Parameter - pSortRecord ΓòÉΓòÉΓòÉ
  3210.  
  3211.  pSortRecord (PVOID) 
  3212.     Function pointer for the sort function for the attribute. 
  3213.  
  3214.  
  3215. ΓòÉΓòÉΓòÉ 2.11. CLASSFIELDINFO ΓòÉΓòÉΓòÉ
  3216.  
  3217. Class field information data structure for use with the wpclsQueryDetailsInfo 
  3218. method. 
  3219.  
  3220. typedef struct _CLASSFIELDINFO {
  3221. ULONG                      cb;                   /*  Size of the CLASSFIELDINFO structure. */
  3222. ULONG                      flData;               /*  Attributes of the field's data. */
  3223. ULONG                      flTitle;              /*  Attributes of the field's title. */
  3224. PVOID                      pTitleData;           /*  Title data. */
  3225. ULONG                      ulReserved;           /*  Reserved. */
  3226. PVOID                      pUserData;            /*  Pointer to user data. */
  3227. struct _CLASSFIELDINFO    *pNextFieldInfo;       /*  Pointer to the next linked CLASSFIELDINFO structure. */
  3228. ULONG                      cxWidth;              /*  Width of the field in pels. */
  3229. ULONG                      offFieldData;         /*  Offset from beginning of this class's data for this field. */
  3230. ULONG                      ulLenFieldData;       /*  Width of data in bytes. */
  3231. PFNOWNDRW                  pfnOwnerDraw;         /*  Ownerdraw procedure for Details View column. */
  3232. ULONG                      flCompare;            /*  Flags. */
  3233. PFNCOMPARE                 pfnCompare;           /*  Pointer to a comparison function. */
  3234. ULONG                      DefaultComparison;    /*  Default comparison operator in the Include Page Criteria dialog box (in the Settings notebook). */
  3235. ULONG                      ulLenCompareValue;    /*  Maximum length of the compare data. */
  3236. PVOID                      pDefCompareValue;     /*  The default value to be used for comparisons. */
  3237. PVOID                      pMinCompareValue;     /*  The default value to be used for comparisons. */
  3238. PVOID                      pMaxCompareValue;     /*  The default value to be used for comparisons. */
  3239. PSZ                        pszEditControlClass;  /*  Window class to be used to edit the compare value. */
  3240. PFNCOMPARE                 pfnSort;              /*  Sort function for this field. */
  3241. PSZ                        pNewComp;             /*  Pointer to an array of strings containing a description of a comparison type. */
  3242.  } CLASSFIELDINFO;
  3243.  
  3244. typedef CLASSFIELDINFO *PCLASSFIELDINFO;
  3245.  
  3246. The CLASSFIELDINFO data structure is similar to the FIELDINFO data structure of 
  3247. the container control, with the following differences: 
  3248.  
  3249.    o  The offStruct field from the FIELDINFO data structure is changed to 
  3250.       ulReserved. 
  3251.  
  3252.    o  Compare, Sort, and Ownerdraw fields (starting at pfnOwnerDraw and 
  3253.       continuing through the end of the structure) have been added so that 
  3254.       object Details View fields can be customized and objects can be found or 
  3255.       included by any of their displayable object Details View fields. 
  3256.  
  3257.    o  The offFieldData and ulLenFieldData fields have been added. 
  3258.  
  3259.       As an example of the use of these two fields, if an application has the 
  3260.       following details data: 
  3261.  
  3262.             typedef struct _SAMPLE {
  3263.                CDATE  cdate;
  3264.                CTIME  ctime;
  3265.                PSZ    psz;
  3266.             }  SAMPLE;
  3267.       then 
  3268.  
  3269.             classfieldinfo[0].offFieldData   = FIELDOFFSET(SAMPLE,cdate);
  3270.             classfieldinfo[0].ulLenFieldData = FIELDOFFSET(SAMPLE,ctime) -
  3271.                                                FIELDOFFSET(SAMPLE,cdate);
  3272.  
  3273.             classfieldinfo[1].offFieldData   = FIELDOFFSET(SAMPLE,ctime);
  3274.             classfieldinfo[1].ulLenFieldData = FIELDOFFSET(SAMPLE,psz) -
  3275.                                                FIELDOFFSET(SAMPLE,ctime);
  3276.  
  3277.             classfieldinfo[2].offFieldData   = FIELDOFFSET(SAMPLE,psz);
  3278.             classfieldinfo[2].ulLenFieldData = sizeof(SAMPLE) -
  3279.                                                FIELDOFFSET(SAMPLE,psz);
  3280.  
  3281.             /* FIELDOFFSET is a macro that calculates the byte offset of a field *
  3282.              * within a structure.                                               */
  3283.  
  3284.       Note:  It is essential that the fields be linked in the order shown 
  3285.              above-cdate must be followed by ctime, and finally psz. 
  3286.  
  3287.  
  3288.  The pfnCompare and pfnSort fields generally point to the same function, but 
  3289.  they can point to different functions if you want them to behave differently. 
  3290.  
  3291.  
  3292. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - cb ΓòÉΓòÉΓòÉ
  3293.  
  3294.  cb (ULONG) 
  3295.     Size of the CLASSFIELDINFO structure. 
  3296.  
  3297.  
  3298. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - flData ΓòÉΓòÉΓòÉ
  3299.  
  3300.  flData (ULONG) 
  3301.     Attributes of the field's data. 
  3302.  
  3303.     Possible values are shown in the following list: 
  3304.  
  3305.    o  Specify one of the following for each column to choose the type of data 
  3306.       that is displayed in each column: 
  3307.  
  3308.            CFA_BITMAPORICON 
  3309.               The column contains bit-map or icon data. 
  3310.  
  3311.            CFA_DATE 
  3312.               The data in the column is displayed in date format. National 
  3313.               Language Support (NLS) is enabled for date format. Use the data 
  3314.               structure described in CDATE 
  3315.  
  3316.            CFA_STRING 
  3317.               Character or text data is displayed in this column. 
  3318.  
  3319.            CFA_TIME 
  3320.               The data in the column is displayed in time format. National 
  3321.               Language Support (NLS) is enabled for time format. Use the data 
  3322.               structure described in CTIME. 
  3323.  
  3324.            CFA_ULONG 
  3325.               Unsigned number data is displayed in this column. National 
  3326.               Language Support (NLS) is enabled for number format. 
  3327.  
  3328.    o  Specify any or all of the following column attributes: 
  3329.  
  3330.            CFA_FIREADONLY 
  3331.               Prevents text in a FIELDINFO data structure (text in a column) 
  3332.               from being edited directly. This attribute applies only to 
  3333.               columns for which the CFA_STRING attribute has been specified. 
  3334.  
  3335.            CFA_HORZSEPARATOR 
  3336.               A horizontal separator is provided beneath column headings. 
  3337.  
  3338.            CFA_INVISIBLE 
  3339.               Invisible container column. The default is visible. 
  3340.  
  3341.            CFA_OWNER 
  3342.               Ownerdraw is enabled for this container column. 
  3343.  
  3344.            CFA_SEPARATOR 
  3345.               A vertical separator is drawn after this column. 
  3346.  
  3347.    o  Specify one of the following for each column to vertically position data 
  3348.       in that column: 
  3349.  
  3350.            CFA_BOTTOM 
  3351.               Bottom-justifies field data. 
  3352.  
  3353.            CFA_TOP 
  3354.               Top-justifies field data. 
  3355.  
  3356.            CFA_VCENTER 
  3357.               Vertically centers field data. This is the default. 
  3358.  
  3359.    o  Specify one of the following for each column to horizontally position 
  3360.       data in that column. These attributes can be combined with the attributes 
  3361.       used for vertical positioning of column data by using an OR operator (|). 
  3362.  
  3363.            CFA_CENTER 
  3364.               Horizontally centers field data. 
  3365.  
  3366.            CFA_LEFT 
  3367.               Left-justifies field data. This is the default. 
  3368.  
  3369.            CFA_RIGHT 
  3370.               Right-justifies field data. 
  3371.  
  3372.    o  Specify the following if new comparison descriptions are used: 
  3373.  
  3374.            CFA_NEWCOMP 
  3375.               Tells the system to use strings specified in pNewComp. 
  3376.  
  3377.    o  Specify the following if a pointer to an object needs to be passed as the 
  3378.       first parameter of a user-defined comparison function: 
  3379.  
  3380.            CFA_OBJECT 
  3381.               Tells the system that the applications wants to use its own 
  3382.               comparison function in which the first parameter is a pointer to 
  3383.               an object. For example: 
  3384.  
  3385.                             LONG MyComp(WPObject *obj, PSZ str2)
  3386.               This flag must be ORed (|) together with one of the type flags 
  3387.               (CFA_BITMAPORICON, CFA_DATE, CFA_STRING, CFA_TIME, or CFA_ULONG) 
  3388.               to tell the object the type that is being compared. 
  3389.  
  3390.  
  3391. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - flTitle ΓòÉΓòÉΓòÉ
  3392.  
  3393.  flTitle (ULONG) 
  3394.     Attributes of the field's title. 
  3395.  
  3396.     Possible values are described in the following list: 
  3397.  
  3398.    o  Specify the following if icon or bit-map data is to be displayed in the 
  3399.       column heading: 
  3400.  
  3401.            CFA_BITMAPORICON 
  3402.               The column heading contains icon or bit-map data. If 
  3403.               CFA_BITMAPORICON is not specified, any data that is assigned to a 
  3404.               column heading is assumed to be character or text data. 
  3405.  
  3406.    o  Specify the following to prevent direct editing of a column heading: 
  3407.  
  3408.            CFA_FITITLEREADONLY 
  3409.               Prevents a column heading from being edited directly. 
  3410.  
  3411.    o  Specify one of the following for each column heading to vertically 
  3412.       position data in that column heading: 
  3413.  
  3414.            CFA_TOP 
  3415.               Top-justifies column headings. 
  3416.            CFA_BOTTOM 
  3417.               Bottom-justifies column headings. 
  3418.            CFA_VCENTER 
  3419.               Vertically centers column headings. This is the default. 
  3420.  
  3421.    o  Specify one of the following for each column heading to horizontally 
  3422.       position data in that column heading. These attributes can be combined 
  3423.       with the attributes used for vertical positioning of column heading data 
  3424.       by using an OR operator (|). 
  3425.  
  3426.            CFA_CENTER 
  3427.               Horizontally centers column headings. 
  3428.            CFA_LEFT 
  3429.               Left-justifies column headings. This is the default. 
  3430.            CFA_RIGHT 
  3431.               Right-justifies column headings. 
  3432.  
  3433.  
  3434. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pTitleData ΓòÉΓòÉΓòÉ
  3435.  
  3436.  pTitleData (PVOID) 
  3437.     Title data. 
  3438.  
  3439.     Default is string. If the flTitle field is set to the CFA_BITMAPORICON 
  3440.     attribute, this must be an icon or bit-map handle. 
  3441.  
  3442.  
  3443. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - ulReserved ΓòÉΓòÉΓòÉ
  3444.  
  3445.  ulReserved (ULONG) 
  3446.     Reserved. 
  3447.  
  3448.  
  3449. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pUserData ΓòÉΓòÉΓòÉ
  3450.  
  3451.  pUserData (PVOID) 
  3452.     Pointer to user data. 
  3453.  
  3454.  
  3455. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pNextFieldInfo ΓòÉΓòÉΓòÉ
  3456.  
  3457.  pNextFieldInfo (struct _CLASSFIELDINFO *) 
  3458.     Pointer to the next linked CLASSFIELDINFO structure. 
  3459.  
  3460.  
  3461. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - cxWidth ΓòÉΓòÉΓòÉ
  3462.  
  3463.  cxWidth (ULONG) 
  3464.     Width of the field in pels. 
  3465.  
  3466.  
  3467. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - offFieldData ΓòÉΓòÉΓòÉ
  3468.  
  3469.  offFieldData (ULONG) 
  3470.     Offset from beginning of this class's data for this field. 
  3471.  
  3472.     The first field is zero. 
  3473.  
  3474.  
  3475. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - ulLenFieldData ΓòÉΓòÉΓòÉ
  3476.  
  3477.  ulLenFieldData (ULONG) 
  3478.     Width of data in bytes. 
  3479.  
  3480.     Four bytes for a pointer. 
  3481.  
  3482.  
  3483. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pfnOwnerDraw ΓòÉΓòÉΓòÉ
  3484.  
  3485.  pfnOwnerDraw (PFNOWNDRW) 
  3486.     Ownerdraw procedure for Details View column. 
  3487.  
  3488.     You would use this if you wanted to draw the field in the Details View of 
  3489.     your object.  An example of this might be if you wanted to draw a graphic 
  3490.     image in the field. 
  3491.  
  3492.     This field can be NULL except if ownerdraw is being used (that is, if the 
  3493.     object is choosing to draw the field itself). 
  3494.  
  3495.  
  3496. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - flCompare ΓòÉΓòÉΓòÉ
  3497.  
  3498.  flCompare (ULONG) 
  3499.     Flags. 
  3500.  
  3501.     Possible values are: 
  3502.  
  3503.       COMPARE_SUPPORTED 
  3504.          Your field can be compared. 
  3505.       SORTBY_SUPPORTED 
  3506.          Your field can be sorted on. 
  3507.  
  3508.  
  3509. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pfnCompare ΓòÉΓòÉΓòÉ
  3510.  
  3511.  pfnCompare (PFNCOMPARE) 
  3512.     Pointer to a comparison function. 
  3513.  
  3514.     A comparison function is used when the object is doing its own Include Page 
  3515.     filtering (in the Settings notebook). 
  3516.  
  3517.     For example, if a string details field exists, the field could be set to 
  3518.     pfnCompare = StringCompare, where StringCompare is defined as: 
  3519.  
  3520.  
  3521.         LONG StringCompare(PSZ str1, PZS str2)
  3522.  
  3523.     This field can be NULL unless ownerdraw is used. 
  3524.  
  3525.  
  3526. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - DefaultComparison ΓòÉΓòÉΓòÉ
  3527.  
  3528.  DefaultComparison (ULONG) 
  3529.     Default comparison operator in the Include Page Criteria dialog box (in the 
  3530.     Settings notebook). 
  3531.  
  3532.     For example, CMP_LESS_OR_EQUAL or CMP_NOT_EQUAL. 
  3533.  
  3534.  
  3535. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - ulLenCompareValue ΓòÉΓòÉΓòÉ
  3536.  
  3537.  ulLenCompareValue (ULONG) 
  3538.     Maximum length of the compare data. 
  3539.  
  3540.     Can be NULL unless ownerdraw is used. 
  3541.  
  3542.  
  3543. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pDefCompareValue ΓòÉΓòÉΓòÉ
  3544.  
  3545.  pDefCompareValue (PVOID) 
  3546.     The default value to be used for comparisons. 
  3547.  
  3548.     Can be NULL unless ownerdraw is used. 
  3549.  
  3550.  
  3551. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pMinCompareValue ΓòÉΓòÉΓòÉ
  3552.  
  3553.  pMinCompareValue (PVOID) 
  3554.     The default value to be used for comparisons. 
  3555.  
  3556.     Can be NULL unless ownerdraw is used. 
  3557.  
  3558.  
  3559. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pMaxCompareValue ΓòÉΓòÉΓòÉ
  3560.  
  3561.  pMaxCompareValue (PVOID) 
  3562.     The default value to be used for comparisons. 
  3563.  
  3564.     Can be NULL unless ownerdraw is used. 
  3565.  
  3566.  
  3567. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pszEditControlClass ΓòÉΓòÉΓòÉ
  3568.  
  3569.  pszEditControlClass (PSZ) 
  3570.     Window class to be used to edit the compare value. 
  3571.  
  3572.     Can be NULL unless ownerdraw is used. 
  3573.  
  3574.  
  3575. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pfnSort ΓòÉΓòÉΓòÉ
  3576.  
  3577.  pfnSort (PFNCOMPARE) 
  3578.     Sort function for this field. 
  3579.  
  3580.     This function is used when the object is doing its own folder sorting. 
  3581.  
  3582.     Can be NULL unless ownerdraw is used. 
  3583.  
  3584.  
  3585. ΓòÉΓòÉΓòÉ <hidden> CLASSFIELDINFO Parameter - pNewComp ΓòÉΓòÉΓòÉ
  3586.  
  3587.  pNewComp (PSZ) 
  3588.     Pointer to an array of strings containing a description of a comparison 
  3589.     type. 
  3590.  
  3591.     The last element of the string must be NULL. 
  3592.  
  3593.     If new comparison types are added, code must be provided for the comparison 
  3594.     function. 
  3595.  
  3596.  
  3597. ΓòÉΓòÉΓòÉ 2.12. CNRINFO ΓòÉΓòÉΓòÉ
  3598.  
  3599. Structure that contains information about the container. 
  3600.  
  3601. typedef struct _CNRINFO {
  3602. ULONG        cb;                  /*  Structure size. */
  3603. PVOID        pSortRecord;         /*  Pointer to the comparison function for sorting container records, or NULL. */
  3604. PFIELDINFO   pFieldInfoLast;      /*  Pointer to the last column in the left window of the split details view, or NULL. */
  3605. PFIELDINFO   pFieldInfoObject;    /*  Pointer to a column that represents an object in the details view. */
  3606. PSZ          pszCnrTitle;         /*  Title text, or NULL. */
  3607. ULONG        flWindowAttr;        /*  Window attributes. */
  3608. POINTL       ptlOrigin;           /*  Workspace origin. */
  3609. ULONG        cDelta;              /*  Threshold. */
  3610. ULONG        cRecords;            /*  Number of records. */
  3611. SIZEL        slBitmapOrIcon;      /*  Icon/bit-map size. */
  3612. SIZEL        slTreeBitmapOrIcon;  /*  Icon/bit-map size. */
  3613. HBITMAP      hbmExpanded;         /*  Bit-map handle. */
  3614. HBITMAP      hbmCollapsed;        /*  Bit-map handle. */
  3615. HPOINTER     hptrExpanded;        /*  Icon handle. */
  3616. HPOINTER     hptrCollapsed;       /*  Icon handle. */
  3617. LONG         cyLineSpacing;       /*  Vertical space. */
  3618. LONG         cxTreeIndent;        /*  Horizontal space. */
  3619. LONG         cxTreeLine;          /*  Line width. */
  3620. ULONG        cFields;             /*  Number of columns. */
  3621. LONG         xVertSplitbar;       /*  Split bar position. */
  3622.  } CNRINFO;
  3623.  
  3624. typedef CNRINFO *PCNRINFO;
  3625.  
  3626.  
  3627. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - cb ΓòÉΓòÉΓòÉ
  3628.  
  3629.  cb (ULONG) 
  3630.     Structure size. 
  3631.  
  3632.     The size (in bytes) of the CNRINFO data structure. 
  3633.  
  3634.  
  3635. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - pSortRecord ΓòÉΓòÉΓòÉ
  3636.  
  3637.  pSortRecord (PVOID) 
  3638.     Pointer to the comparison function for sorting container records, or NULL. 
  3639.  
  3640.     If NULL, which is the default condition, no sorting is performed. Sorting 
  3641.     occurs only during record insertion and when changing the value of this 
  3642.     field. The third parameter of the comparison function, pStorage, must be 
  3643.     NULL. See "CM_SORTRECORD" in the Presentation Manager Programming Reference 
  3644.     for a further description of the comparison function. 
  3645.  
  3646.  
  3647. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - pFieldInfoLast ΓòÉΓòÉΓòÉ
  3648.  
  3649.  pFieldInfoLast (PFIELDINFO) 
  3650.     Pointer to the last column in the left window of the split details view, or 
  3651.     NULL. 
  3652.  
  3653.     The default is NULL, which causes all columns to be positioned in the left 
  3654.     window. 
  3655.  
  3656.  
  3657. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - pFieldInfoObject ΓòÉΓòÉΓòÉ
  3658.  
  3659.  pFieldInfoObject (PFIELDINFO) 
  3660.     Pointer to a column that represents an object in the details view. 
  3661.  
  3662.     The data for this FIELDINFO structure must contain icons or bit maps. 
  3663.     In-use emphasis is applied to this column of icons or bit maps only. The 
  3664.     default is the leftmost column in the unsplit details view or the leftmost 
  3665.     column in the left window of the split details view. 
  3666.  
  3667.  
  3668. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - pszCnrTitle ΓòÉΓòÉΓòÉ
  3669.  
  3670.  pszCnrTitle (PSZ) 
  3671.     Title text, or NULL. 
  3672.  
  3673.     Text for the container title. The default is NULL. 
  3674.  
  3675.  
  3676. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - flWindowAttr ΓòÉΓòÉΓòÉ
  3677.  
  3678.  flWindowAttr (ULONG) 
  3679.     Window attributes. 
  3680.  
  3681.     Consists of container window attributes. 
  3682.  
  3683.    o  Specify one of the following container views, which determine the 
  3684.       presentation format of items in a container: 
  3685.  
  3686.            CV_ICON 
  3687.               In the icon view, the container items are represented as 
  3688.               icon/text or bit-map/text pairs, with text beneath the icons or 
  3689.               bit maps. This is the default view. This view can be combined 
  3690.               with the CV_MINI style bit by using an OR operator (|). 
  3691.  
  3692.            CV_NAME 
  3693.               In the name view, the container items are represented as 
  3694.               icon/text or bit-map/text pairs, with text to the right of the 
  3695.               icons or bit maps. This view can be combined with the CV_MINI and 
  3696.               CV_FLOW style bits by using OR operators (|). 
  3697.  
  3698.            CV_TEXT 
  3699.               In the text view, the container items are displayed as a list of 
  3700.               text strings. This view can be combined with the CV_FLOW style 
  3701.               bit by using an OR operator (|). 
  3702.  
  3703.            CV_TREE 
  3704.               In the tree view, the container items are represented in a 
  3705.               hierarchical manner. The tree view has three forms, which are 
  3706.               defined in the following list. If you specify CV_TREE by itself, 
  3707.               the tree icon view is used. 
  3708.  
  3709.              -  Tree icon view 
  3710.  
  3711.                 The tree icon view is specified by using a logical OR operator 
  3712.                 to combine the tree view with the icon view 
  3713.                 (CV_TREE | CV_ICON). Container items in this view are 
  3714.                 represented as icon/text pairs or bit-map/text pairs, with text 
  3715.                 to the right of the icons or bit maps. Also, a collapsed or 
  3716.                 expanded icon or bit map is displayed to the left of parent 
  3717.                 items. If this icon or bit map is a collapsed icon or bit map, 
  3718.                 selecting it will cause the parent item to be expanded so that 
  3719.                 its child items are displayed below it. If this icon or bit map 
  3720.                 is an expanded icon or bit map, selecting it will cause the 
  3721.                 parent's child items to be removed from the display. The 
  3722.                 default collapsed and expanded bit maps provided by the 
  3723.                 container use a plus sign (+) and a minus sign (-), 
  3724.                 respectively, to indicate that items can be added to or 
  3725.                 subtracted from the display. 
  3726.  
  3727.              -  Tree name view 
  3728.  
  3729.                 The tree name view is specified by using a logical OR operator 
  3730.                 to combine the tree view with the name view 
  3731.                 (CV_TREE | CV_NAME). Container items in this view are displayed 
  3732.                 as either icon/text pairs or bit-map/text pairs, with text to 
  3733.                 the right of the icons or bit maps. However, the indicator that 
  3734.                 represents whether an item can be collapsed or expanded, such 
  3735.                 as a plus or minus sign, is included in the icon or bit map 
  3736.                 that represents that item, not in a separate icon or bit map as 
  3737.                 in the tree icon and tree text views. The container control 
  3738.                 does not provide default collapsed and expanded bit maps for 
  3739.                 the tree name view. 
  3740.  
  3741.              -  Tree text view 
  3742.  
  3743.                 The tree text view is specified by using a logical OR operator 
  3744.                 to combine the tree view with the text view 
  3745.                 (CV_TREE | CV_TEXT). Container items in this view are displayed 
  3746.                 as a list of text strings. As in the tree icon view, a 
  3747.                 collapsed or expanded icon or bit map is displayed to the left 
  3748.                 of parent items. 
  3749.  
  3750.            CV_DETAIL 
  3751.               In the details view, the container items are presented in 
  3752.               columns. Each column can contain icons or bit maps, text, 
  3753.               numbers, dates, or times. 
  3754.  
  3755.    o  Specify one or both of the following view styles by using an OR operator 
  3756.       (|) to combine them with the specified view. These view styles are 
  3757.       optional. 
  3758.  
  3759.            CV_MINI 
  3760.               Produces a mini-icon whose size is based on the Presentation 
  3761.               Manager (PM) SV_CYMENU system value to produce a device-dependent 
  3762.               mini-icon. 
  3763.  
  3764.               The CV_MINI view style bit is ignored when: 
  3765.  
  3766.              -  The text view (CV_TEXT), tree view (CV_TREE), or details view 
  3767.                 (CV_DETAIL) are displayed 
  3768.  
  3769.              -  The CCS_MINIRECORDCORE style bit is specified. 
  3770.  
  3771.               If this style bit is not specified and the icon view (CV_ICON) or 
  3772.               name view (CV_NAME) is used, the default, regular-sized icon is 
  3773.               used. The size of regular-sized icons is based on the value in 
  3774.               the slBitmapOrIcon field of the CNRINFO data structure. If this 
  3775.               field is equal to 0, the PM SV_CXICON and SV_CYICON system values 
  3776.               for width and height, respectively, are used. Icon sizes are 
  3777.               consistent with PM-defined icon sizes for all devices. 
  3778.  
  3779.            CV_FLOW 
  3780.               Dynamically arranges container items in columns in the name and 
  3781.               text views. These are called flowed name and flowed text views. 
  3782.               If this style bit is set for the name view (CV_NAME) or text view 
  3783.               (CV_TEXT), the container items are placed in a single column 
  3784.               until the bottom of the client area is reached. The next 
  3785.               container item is placed in the adjacent column to the right of 
  3786.               the filled column. This process is repeated until all of the 
  3787.               container items are positioned in the container. The width of 
  3788.               each column is determined by the longest text string in that 
  3789.               column. The size of the window determines the depth of the client 
  3790.               area. 
  3791.  
  3792.               If this style bit is not specified, the default condition for the 
  3793.               name and text views is to vertically fill the container in a 
  3794.               single column without flowing the container items. If this style 
  3795.               bit is set for the icon view (CV_ICON) or details view 
  3796.               (CV_DETAIL), it is ignored. 
  3797.  
  3798.    o  Specify either of the following to indicate whether the container will 
  3799.       display icons or bit maps: 
  3800.  
  3801.            CA_DRAWICON 
  3802.               Icons are used for the icon, name, tree, or details views. This 
  3803.               is the default. This container attribute should be used with the 
  3804.               hptrIcon and hptrMiniIcon fields of the RECORDCORE data 
  3805.               structure. 
  3806.  
  3807.            CA_DRAWBITMAP 
  3808.               Bit maps are used for the icon, name, tree, or details views. 
  3809.               This container attribute can be used with the hbmBitmap and 
  3810.               hbmMiniBitmap fields of the RECORDCORE data structure. 
  3811.  
  3812.               Notes 
  3813.  
  3814.              1. If both the CA_DRAWICON and CA_DRAWBITMAP attributes are 
  3815.                 specified, the CA_DRAWICON attribute is used. 
  3816.  
  3817.              2. If the CCS_MINIRECORDCORE style bit is specified when a 
  3818.                 container is created, the hptrIcon field of the MINIRECORDCORE 
  3819.                 data structure is used. 
  3820.  
  3821.    o  Specify one of the following attributes to provide target emphasis for 
  3822.       the name, text, and details views. If neither ordered nor mixed target 
  3823.       emphasis is specified, the emphasis is drawn around the record. 
  3824.  
  3825.            CA_ORDEREDTARGETEMPH 
  3826.               Shows where a container record can be dropped during direct 
  3827.               manipulation by drawing a line beneath the record. Ordered target 
  3828.               emphasis does not apply to the icon and tree views. 
  3829.  
  3830.            CA_MIXEDTARGETEMPH 
  3831.               Shows where a container record can be dropped during direct 
  3832.               manipulation either by drawing a line between two items or by 
  3833.               drawing lines around the container record. Mixed target emphasis 
  3834.               does not apply to the icon and tree views. 
  3835.  
  3836.    o  Specify the following attribute to draw lines that show the relationship 
  3837.       between items in the tree view. 
  3838.  
  3839.            CA_TREELINE 
  3840.               Shows the relationship between all items in the tree view. 
  3841.  
  3842.    o  Specify the following to draw container records, paint the background of 
  3843.       the container, or both: 
  3844.  
  3845.            CA_OWNERDRAW 
  3846.               Ownerdraw for the container, which allows the application to draw 
  3847.               container records. 
  3848.  
  3849.            CA_OWNERPAINTBACKGROUND 
  3850.               Allows the application to subclass the container and paint the 
  3851.               background. If specified, and the container is subclassed, the 
  3852.               application receives the CM_PAINTBACKGROUND message in the 
  3853.               subclass procedure. Otherwise, the container paints the 
  3854.               background using the color specified by SYSCLR_WINDOW, which can 
  3855.               be changed by using the PP_BACKGROUNDCOLOR or 
  3856.               PP_BACKGROUNDCOLORINDEX presentation parameter in the 
  3857.               WM_PRESPARAMCHANGED (in Container Controls) 
  3858.  
  3859.    o  Specify the following if the container is to have a title: 
  3860.  
  3861.            CA_CONTAINERTITLE 
  3862.               Allows you to include a container title. The default is no 
  3863.               container title. 
  3864.  
  3865.    o  Specify one or both of the following container title attributes. These 
  3866.       are valid only if the CA_CONTAINERTITLE attribute is specified. 
  3867.  
  3868.            CA_TITLEREADONLY 
  3869.               Prevents the container title from being edited directly. The 
  3870.               default is to allow the container title to be edited. 
  3871.  
  3872.            CA_TITLESEPARATOR 
  3873.               Puts a separator line between the container title and the records 
  3874.               beneath it. The default is no separator line. 
  3875.  
  3876.    o  Specify one of the following to position the container title. These are 
  3877.       valid only if the CA_CONTAINERTITLE attribute is specified. 
  3878.  
  3879.            CA_TITLECENTER 
  3880.               Centers the container title. This is the default. 
  3881.  
  3882.            CA_TITLELEFT 
  3883.               Left-justifies the container title. 
  3884.  
  3885.            CA_TITLERIGHT 
  3886.               Right-justifies the container title. 
  3887.  
  3888.    o  Specify the following to display column headings in the details view: 
  3889.  
  3890.            CA_DETAILSVIEWTITLES 
  3891.               Allows you to include column headings in the details view. The 
  3892.               default is no column headings. 
  3893.  
  3894.  
  3895. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - ptlOrigin ΓòÉΓòÉΓòÉ
  3896.  
  3897.  ptlOrigin (POINTL) 
  3898.     Workspace origin. 
  3899.  
  3900.     Lower-left origin of the workspace in virtual coordinates, used in the icon 
  3901.     view. The default origin is (0,0). 
  3902.  
  3903.  
  3904. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - cDelta ΓòÉΓòÉΓòÉ
  3905.  
  3906.  cDelta (ULONG) 
  3907.     Threshold. 
  3908.  
  3909.     An application-defined threshold, or number of records, from either end of 
  3910.     the list of available records. Used when a container needs to handle large 
  3911.     amounts of data. The default is 0. See the OS/2 Programming Guide for more 
  3912.     information about specifying deltas. 
  3913.  
  3914.  
  3915. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - cRecords ΓòÉΓòÉΓòÉ
  3916.  
  3917.  cRecords (ULONG) 
  3918.     Number of records. 
  3919.  
  3920.     The number of records in the container. Initially, this field is 0. 
  3921.  
  3922.  
  3923. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - slBitmapOrIcon ΓòÉΓòÉΓòÉ
  3924.  
  3925.  slBitmapOrIcon (SIZEL) 
  3926.     Icon/bit-map size. 
  3927.  
  3928.     The size (in pels) of icons or bit maps. The default is the system size. 
  3929.  
  3930.  
  3931. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - slTreeBitmapOrIcon ΓòÉΓòÉΓòÉ
  3932.  
  3933.  slTreeBitmapOrIcon (SIZEL) 
  3934.     Icon/bit-map size. 
  3935.  
  3936.     The size (in pels) of the expanded and collapsed icons or bit maps used in 
  3937.     the tree icon and tree text views. 
  3938.  
  3939.  
  3940. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - hbmExpanded ΓòÉΓòÉΓòÉ
  3941.  
  3942.  hbmExpanded (HBITMAP) 
  3943.     Bit-map handle. 
  3944.  
  3945.     The handle of the bit map to be used to represent an expanded parent item 
  3946.     in the tree icon and tree text views. If neither an icon handle (see 
  3947.     hptrExpanded) nor a bit-map handle is specified, a default bit map with a 
  3948.     minus sign (-) is provided. 
  3949.  
  3950.  
  3951. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - hbmCollapsed ΓòÉΓòÉΓòÉ
  3952.  
  3953.  hbmCollapsed (HBITMAP) 
  3954.     Bit-map handle. 
  3955.  
  3956.     The handle of the bit map to be used to represent a collapsed parent item 
  3957.     in the tree icon and tree text views. If neither an icon handle (see 
  3958.     hptrCollapsed) nor a bit-map handle is specified, a default bit map with a 
  3959.     plus sign (+) is provided. 
  3960.  
  3961.  
  3962. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - hptrExpanded ΓòÉΓòÉΓòÉ
  3963.  
  3964.  hptrExpanded (HPOINTER) 
  3965.     Icon handle. 
  3966.  
  3967.     The handle of the icon to be used to represent an expanded parent item in 
  3968.     the tree icon and tree text views. If neither an icon handle nor a bit-map 
  3969.     handle (see hbmExpanded) is specified, a default bit map with a minus sign 
  3970.     (-) is provided. 
  3971.  
  3972.  
  3973. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - hptrCollapsed ΓòÉΓòÉΓòÉ
  3974.  
  3975.  hptrCollapsed (HPOINTER) 
  3976.     Icon handle. 
  3977.  
  3978.     The handle of the icon to be used to represent a collapsed parent item in 
  3979.     the tree icon and tree text views. If neither an icon handle nor a bit-map 
  3980.     handle (see hbmCollapsed) is specified, a default bit map with a plus sign 
  3981.     (+) is provided. 
  3982.  
  3983.  
  3984. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - cyLineSpacing ΓòÉΓòÉΓòÉ
  3985.  
  3986.  cyLineSpacing (LONG) 
  3987.     Vertical space. 
  3988.  
  3989.     The amount of vertical space (in pels) between the records. If you specify 
  3990.     a value that is less than 0, a default value is used. 
  3991.  
  3992.  
  3993. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - cxTreeIndent ΓòÉΓòÉΓòÉ
  3994.  
  3995.  cxTreeIndent (LONG) 
  3996.     Horizontal space. 
  3997.  
  3998.     The amount of horizontal space (in pels) between levels in the tree view. 
  3999.     If you specify a value that is less than 0, a default value is used. 
  4000.  
  4001.  
  4002. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - cxTreeLine ΓòÉΓòÉΓòÉ
  4003.  
  4004.  cxTreeLine (LONG) 
  4005.     Line width. 
  4006.  
  4007.     The width of the lines (in pels) that show the relationship between tree 
  4008.     items. If you specify a value that is less than 0, a default value is used. 
  4009.     Also, if the CA_TREELINE container attribute of the flWindowAttr field is 
  4010.     not specified, these lines are not drawn. 
  4011.  
  4012.  
  4013. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - cFields ΓòÉΓòÉΓòÉ
  4014.  
  4015.  cFields (ULONG) 
  4016.     Number of columns. 
  4017.  
  4018.     The number of FIELDINFO structures in the container. Initially, this field 
  4019.     is 0. 
  4020.  
  4021.  
  4022. ΓòÉΓòÉΓòÉ <hidden> CNRINFO Parameter - xVertSplitbar ΓòÉΓòÉΓòÉ
  4023.  
  4024.  xVertSplitbar (LONG) 
  4025.     Split bar position. 
  4026.  
  4027.     The initial position of the split bar relative to the container used in the 
  4028.     details view. If this value is less than 0, the split bar is not used. The 
  4029.     default value is negative one (-1). 
  4030.  
  4031.  
  4032. ΓòÉΓòÉΓòÉ 2.13. CTIME ΓòÉΓòÉΓòÉ
  4033.  
  4034. Structure that contains time information for a data element in the details view 
  4035. of a container control. 
  4036.  
  4037. typedef struct _CTIME {
  4038. UCHAR   hours;       /*  Current hour. */
  4039. UCHAR   minutes;     /*  Current minute. */
  4040. UCHAR   seconds;     /*  Current second. */
  4041. UCHAR   ucReserved;  /*  Reserved. */
  4042.  } CTIME;
  4043.  
  4044. typedef CTIME *PCTIME;
  4045.  
  4046.  
  4047. ΓòÉΓòÉΓòÉ <hidden> CTIME Parameter - hours ΓòÉΓòÉΓòÉ
  4048.  
  4049.  hours (UCHAR) 
  4050.     Current hour. 
  4051.  
  4052.  
  4053. ΓòÉΓòÉΓòÉ <hidden> CTIME Parameter - minutes ΓòÉΓòÉΓòÉ
  4054.  
  4055.  minutes (UCHAR) 
  4056.     Current minute. 
  4057.  
  4058.  
  4059. ΓòÉΓòÉΓòÉ <hidden> CTIME Parameter - seconds ΓòÉΓòÉΓòÉ
  4060.  
  4061.  seconds (UCHAR) 
  4062.     Current second. 
  4063.  
  4064.  
  4065. ΓòÉΓòÉΓòÉ <hidden> CTIME Parameter - ucReserved ΓòÉΓòÉΓòÉ
  4066.  
  4067.  ucReserved (UCHAR) 
  4068.     Reserved. 
  4069.  
  4070.  
  4071. ΓòÉΓòÉΓòÉ 2.14. DEVOPENSTRUC ΓòÉΓòÉΓòÉ
  4072.  
  4073. Open-device data structure. 
  4074.  
  4075. typedef struct _DEVOPENSTRUC {
  4076. PSZ         pszLogAddress;       /*  Logical address. */
  4077. PSZ         pszDriverName;       /*  Driver name. */
  4078. PDRIVDATA   pdriv;               /*  Driver data. */
  4079. PSZ         pszDataType;         /*  Data type. */
  4080. PSZ         pszComment;          /*  Comment. */
  4081. PSZ         pszQueueProcName;    /*  Queue-processor name. */
  4082. PSZ         pszQueueProcParams;  /*  Queue-processor parameters. */
  4083. PSZ         pszSpoolerParams;    /*  Spooler parameters. */
  4084. PSZ         pszNetworkParams;    /*  Network parameters. */
  4085.  } DEVOPENSTRUC;
  4086.  
  4087. typedef DEVOPENSTRUC *PDEVOPENSTRUC;
  4088.  
  4089.  
  4090. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pszLogAddress ΓòÉΓòÉΓòÉ
  4091.  
  4092.  pszLogAddress (PSZ) 
  4093.     Logical address. 
  4094.  
  4095.     This is required for an OD_DIRECT device being opened with DevOpenDC; it is 
  4096.     the logical device address, such as "LPT1" on OS/2. Some drivers may accept 
  4097.     a file name for this parameter or even a named pipe. 
  4098.  
  4099.     Where output is to be queued (for an OD_QUEUED device), this is the name of 
  4100.     the queue for the output device. The queue name can be a UNC name. 
  4101.  
  4102.     Note:  This parameter can be a port name for a printer device context. 
  4103.  
  4104.  
  4105. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pszDriverName ΓòÉΓòÉΓòÉ
  4106.  
  4107.  pszDriverName (PSZ) 
  4108.     Driver name. 
  4109.  
  4110.     Character string identifying the printer driver, for example, LASERJET. The 
  4111.     Default Device Driver field of the PRQINFO3 structure, associated with the 
  4112.     required print queue, gives the driver and device name, separated by a 
  4113.     period, for example LASERJET.HP LaserJet IIID. It can contain only the name 
  4114.     up to the period, for example LASERJET. 
  4115.  
  4116.  
  4117. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pdriv ΓòÉΓòÉΓòÉ
  4118.  
  4119.  pdriv (PDRIVDATA) 
  4120.     Driver data. 
  4121.  
  4122.     Data that is to be passed directly to the PM device driver. Whether any of 
  4123.     this is required depends upon the device driver. 
  4124.  
  4125.     For printer device context, this is a pointer to the job properties data. 
  4126.  
  4127.  
  4128. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pszDataType ΓòÉΓòÉΓòÉ
  4129.  
  4130.  pszDataType (PSZ) 
  4131.     Data type. 
  4132.  
  4133.     For an OD_QUEUED or OD_DIRECT device, this parameter defines the type of 
  4134.     data that is to be queued as follows: 
  4135.  
  4136.       PM_Q_STD   Standard format 
  4137.       PM_Q_RAW   Raw format 
  4138.  
  4139.     Note that a device driver can define other data types. 
  4140.  
  4141.     For OD_QUEUED or OD_DIRECT defice types, the default is supplied by the 
  4142.     device driver if pszDataType is not specified. For any other device type, 
  4143.     pszDataType is ignored. 
  4144.  
  4145.  
  4146. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pszComment ΓòÉΓòÉΓòÉ
  4147.  
  4148.  pszComment (PSZ) 
  4149.     Comment. 
  4150.  
  4151.     Optional character string that the printer object displays to the user in a 
  4152.     job settings notebook. It is recommended that the application include its 
  4153.     own name in this comment string. 
  4154.  
  4155.     Note:  The job title text is derived from the document name passed to 
  4156.            DevEscape (DEVESC_STARTDOC). 
  4157.  
  4158.  
  4159. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pszQueueProcName ΓòÉΓòÉΓòÉ
  4160.  
  4161.  pszQueueProcName (PSZ) 
  4162.     Queue-processor name. 
  4163.  
  4164.     This is the name of the queue processor, for queued output, and is usually 
  4165.     the default. 
  4166.  
  4167.  
  4168. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pszQueueProcParams ΓòÉΓòÉΓòÉ
  4169.  
  4170.  pszQueueProcParams (PSZ) 
  4171.     Queue-processor parameters. 
  4172.  
  4173.     Queue processor parameters (optional). They can include information such as 
  4174.     the number of copies you want to print and the size of the output area on 
  4175.     the printed page. 
  4176.  
  4177.     The first parameter (COP) is used for all spool-file formats. The remaining 
  4178.     parameters are valid for PM_Q_STD spool files only. Because PM_Q_STD data 
  4179.     are used mainly for graphic data, these parameters are described in 
  4180.     relation to the printing of picture files. 
  4181.  
  4182.     The PMPRINT/PMPLOT queue-processor parameters are separated by spaces and 
  4183.     are: 
  4184.  
  4185.       COP=  n 
  4186.           The COP parameter specifies the number of copies of the spool file 
  4187.           that you want printed. The value of n must be an integer in the range 
  4188.           of 1 through 999. 
  4189.  
  4190.           The default is COP=1. 
  4191.  
  4192.       ARE=C |  w,h,l,t 
  4193.           The ARE parameter determines the size and position of the output 
  4194.           area. This is the area of the physical page to which printing is 
  4195.           restricted. 
  4196.  
  4197.           The default value of ARE=C means that the output area is the whole 
  4198.           page. Note, however, that the printer cannot print outside its own 
  4199.           device clip limits. 
  4200.  
  4201.           To size and position the output area at a specific point on the page, 
  4202.           use ARE=  w,h,l,t , where: 
  4203.  
  4204.            w, h           are the width and height of the desired output area. 
  4205.  
  4206.            l, t           are the offsets of the upper-left corner of the 
  4207.                           output area from the left (l) and from the top (t) of 
  4208.                           the maximum output area. 
  4209.  
  4210.           These four values must be given as percentages of the maximum output 
  4211.           dimensions. The maximum output area is the area within the device 
  4212.           clip limits. 
  4213.  
  4214.       FIT=S |  l,t 
  4215.           The FIT parameter determines which part of the picture is to be 
  4216.           printed. You can request the whole of the picture, scaled to fit the 
  4217.           output area; or you can position the picture (actual size) anywhere 
  4218.           within the output area. This could mean that the picture is clipped 
  4219.           at the boundaries of the output area. 
  4220.  
  4221.           The default value of FIT=S causes the output to be scaled until the 
  4222.           larger of the height or width just fits within the defined output 
  4223.           area. The aspect ratio of the picture is maintained. 
  4224.  
  4225.           To print the picture in actual size, use FIT=  l,t , where l,t are 
  4226.           the coordinates of the point in the picture that you want positioned 
  4227.           at the center of the output area: l is measured from the left edge of 
  4228.           the picture; and t is measured from the top edge. The coordinates 
  4229.           must be given as percentages of the actual dimensions of the picture. 
  4230.  
  4231.       XFM=0 | 1 
  4232.           The XFM parameter enables you to override the picture-positioning and 
  4233.           clipping instructions that are provided by the ARE and FIT 
  4234.           parameters, including their defaults. 
  4235.  
  4236.           The default value of XFM=1 allows the appearance of the output to be 
  4237.           determined by the settings of the ARE and FIT parameters. 
  4238.  
  4239.           A value of XFM=0 yields output as specified in the picture file. For 
  4240.           example, applications that use many different forms can define 
  4241.           different positions on each form for their output. 
  4242.  
  4243.       COL=M | C 
  4244.           The COL parameter enables you to specify color output if you have a 
  4245.           color printer. 
  4246.  
  4247.           A value of COL=M creates monochrome output (black foreground with no 
  4248.           background color). This is supported by all devices. 
  4249.  
  4250.           A value of COL=C creates color output. If you request color output on 
  4251.           a monochrome device, the printer presentation driver tries to satisfy 
  4252.           your request, which can cause problems because the only color 
  4253.           available is black. For example, if the picture file specifies a red 
  4254.           line on a blue background, both are drawn in black. 
  4255.  
  4256.           The default is COL=M when you are addressing a monochrome printer and 
  4257.           COL=C when you are addressing a color printer. 
  4258.  
  4259.       MAP=N | A 
  4260.           The MAP parameter enables you to decide how the neutral colors (those 
  4261.           that are not specified in the picture file) are printed. 
  4262.  
  4263.           The default value of MAP=N yields a normal representation of the 
  4264.           screen picture on a printed page, which means that the page 
  4265.           background is white and the foreground is black. 
  4266.  
  4267.           A value of MAP=A provides the reverse of the normal representation: 
  4268.           the background is black and the foreground is white on the printed 
  4269.           page. 
  4270.  
  4271.       CDP=codepage 
  4272.           The CDP parameter overrides the codepage to being used for PM_Q_RAW 
  4273.           print jobs. The print queue driver uses DEVESC_SETMODE to set the 
  4274.           codepage, but not all printer drivers support this device escape. 
  4275.  
  4276.       XLT=0 | 1 
  4277.           The XLT parameter can eliminate the translation component when 
  4278.           printing a metafile if XLT=1. 
  4279.  
  4280.           When the resolution of the device is higher than that of the world 
  4281.           coordinate space, a small translation of world coordinate point (0,0) 
  4282.           occurs on the device to preserve the accuracy of the mapping from 
  4283.           world to device coordinate units. For example, (0,0) becomes (1,1) if 
  4284.           there are 3 pels to every world coordinate. 
  4285.  
  4286.           Normally, this is not noticeable, but it can be a problem with some 
  4287.           devices. For example, in order to draw a complete row of 80 
  4288.           characters using a device font, a device may require the text to 
  4289.           start at device coordinate position zero. Starting at a position 
  4290.           other than zero may cause one or more characters at the end of the 
  4291.           row to be clipped. In such cases, elimination of the translation is 
  4292.           important and can be accomplished by specifying XLT=1. 
  4293.  
  4294.           The default is XLT=0. 
  4295.  
  4296.  
  4297. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pszSpoolerParams ΓòÉΓòÉΓòÉ
  4298.  
  4299.  pszSpoolerParams (PSZ) 
  4300.     Spooler parameters. 
  4301.  
  4302.     Spooler parameters (optional) are separated by spaces. They are used for 
  4303.     scheduling print jobs and are as follows: 
  4304.  
  4305.    o  The form names that identify the paper to be used, for example, 
  4306.       FORM=A4,A5,ENV. The form names are optional; but if they are provided, 
  4307.       the spooler is able to hold off printing the jobs until the required form 
  4308.       is installed in the printer. If the form name is not provided, the 
  4309.       spooler attempts to print the job. The printer driver recognizes that 
  4310.       there is a forms problem and displays a FORMS MISMATCH message box. 
  4311.  
  4312.    o  Priority of the print job, for example, PRTY=60. The priority is 
  4313.       specified as an integer in the range 1 through 99; 99 is the highest. The 
  4314.       default priority value is 50. The application can use the spooler 
  4315.       priority parameter to prioritize its own jobs; however, it is not good 
  4316.       practice for an application always to use priority 99 in an attempt to 
  4317.       get its jobs printed first. 
  4318.  
  4319.  
  4320. ΓòÉΓòÉΓòÉ <hidden> DEVOPENSTRUC Parameter - pszNetworkParams ΓòÉΓòÉΓòÉ
  4321.  
  4322.  pszNetworkParams (PSZ) 
  4323.     Network parameters. 
  4324.  
  4325.     Optional parameter that can be used to specify network options; for 
  4326.     example, USER=JOESMITH. 
  4327.  
  4328.  
  4329. ΓòÉΓòÉΓòÉ 2.15. DRAGIMAGE ΓòÉΓòÉΓòÉ
  4330.  
  4331. Dragged-object-image structure which describes the images that are to be drawn 
  4332. under the direct-manipulation pointer for the duration of a drag operation. 
  4333.  
  4334. typedef struct _DRAGIMAGE {
  4335. USHORT    cb;           /*  Size, in bytes, of the DRAGIMAGE structure. */
  4336. USHORT    cptl;         /*  The number of points in the point array if fl is specified as DRG_POLYGON. */
  4337. LHANDLE   hImage;       /*  Handle representing the image to display. */
  4338. SIZEL     sizlStretch;  /*  Dimensions for stretching when fl is specified as DRG_STRETCH. */
  4339. ULONG     fl;           /*  Flags. */
  4340. SHORT     cxOffset;     /*  X-offset from the pointer hot spot to the origin of the image. */
  4341. SHORT     cyOffset;     /*  Y-offset from the pointer hot spot to the origin of the image. */
  4342.  } DRAGIMAGE;
  4343.  
  4344. typedef DRAGIMAGE *PDRAGIMAGE;
  4345.  
  4346.  
  4347. ΓòÉΓòÉΓòÉ <hidden> DRAGIMAGE Parameter - cb ΓòÉΓòÉΓòÉ
  4348.  
  4349.  cb (USHORT) 
  4350.     Size, in bytes, of the DRAGIMAGE structure. 
  4351.  
  4352.  
  4353. ΓòÉΓòÉΓòÉ <hidden> DRAGIMAGE Parameter - cptl ΓòÉΓòÉΓòÉ
  4354.  
  4355.  cptl (USHORT) 
  4356.     The number of points in the point array if fl is specified as DRG_POLYGON. 
  4357.  
  4358.  
  4359. ΓòÉΓòÉΓòÉ <hidden> DRAGIMAGE Parameter - hImage ΓòÉΓòÉΓòÉ
  4360.  
  4361.  hImage (LHANDLE) 
  4362.     Handle representing the image to display. 
  4363.  
  4364.     The type is determined by fl. 
  4365.  
  4366.  
  4367. ΓòÉΓòÉΓòÉ <hidden> DRAGIMAGE Parameter - sizlStretch ΓòÉΓòÉΓòÉ
  4368.  
  4369.  sizlStretch (SIZEL) 
  4370.     Dimensions for stretching when fl is specified as DRG_STRETCH. 
  4371.  
  4372.  
  4373. ΓòÉΓòÉΓòÉ <hidden> DRAGIMAGE Parameter - fl ΓòÉΓòÉΓòÉ
  4374.  
  4375.  fl (ULONG) 
  4376.     Flags. 
  4377.  
  4378.       DRG_ICON 
  4379.          hImage is an HPOINTER. 
  4380.       DRG_BITMAP 
  4381.          hImage is an HBITMAP. 
  4382.       DRG_POLYGON 
  4383.          hImage is a pointer to an array of points that will be connected with 
  4384.          GpiPolyLine to form a polygon. The first point of the array should be 
  4385.          (0,0), and the other points should be placed relative to this 
  4386.          position. 
  4387.       DRG_STRETCH 
  4388.          If DRG_ICON or DRG_BITMAP is specified, the image is expanded or 
  4389.          compressed to the dimensions specified by sizlStretch. 
  4390.       DRG_TRANSPARENT 
  4391.          If DRG_ICON is specified, an outline of the icon is generated and 
  4392.          displayed instead of the original icon. 
  4393.       DRG_CLOSED 
  4394.          If DRG_POLYGON is specified, a closed polygon is formed by moving the 
  4395.          current position to the last point in the array before calling 
  4396.          GpiPolyLine. 
  4397.  
  4398.  
  4399. ΓòÉΓòÉΓòÉ <hidden> DRAGIMAGE Parameter - cxOffset ΓòÉΓòÉΓòÉ
  4400.  
  4401.  cxOffset (SHORT) 
  4402.     X-offset from the pointer hot spot to the origin of the image. 
  4403.  
  4404.  
  4405. ΓòÉΓòÉΓòÉ <hidden> DRAGIMAGE Parameter - cyOffset ΓòÉΓòÉΓòÉ
  4406.  
  4407.  cyOffset (SHORT) 
  4408.     Y-offset from the pointer hot spot to the origin of the image. 
  4409.  
  4410.  
  4411. ΓòÉΓòÉΓòÉ 2.16. DRAGINFO ΓòÉΓòÉΓòÉ
  4412.  
  4413. Drag-information structure. 
  4414.  
  4415. typedef struct _DRAGINFO {
  4416. ULONG    cbDraginfo;   /*  Structure size, in bytes. */
  4417. USHORT   cbDragitem;   /*  Size, in bytes, of each DRAGITEM structure. */
  4418. USHORT   usOperation;  /*  Modified drag operations. */
  4419. HWND     hwndSource;   /*  Window handle of the source of the drag operation. */
  4420. SHORT    xDrop;        /*  X-coordinate of drop point expressed in desktop coordinates. */
  4421. SHORT    yDrop;        /*  Y-coordinate of drop point expressed in desktop coordinates. */
  4422. USHORT   cditem;       /*  Count of DRAGITEM structures. */
  4423. USHORT   usReserved;   /*  Reserved. */
  4424.  } DRAGINFO;
  4425.  
  4426. typedef DRAGINFO *PDRAGINFO;
  4427.  
  4428.  
  4429. ΓòÉΓòÉΓòÉ <hidden> DRAGINFO Parameter - cbDraginfo ΓòÉΓòÉΓòÉ
  4430.  
  4431.  cbDraginfo (ULONG) 
  4432.     Structure size, in bytes. 
  4433.  
  4434.     The size includes the array of DRAGITEM structures. 
  4435.  
  4436.  
  4437. ΓòÉΓòÉΓòÉ <hidden> DRAGINFO Parameter - cbDragitem ΓòÉΓòÉΓòÉ
  4438.  
  4439.  cbDragitem (USHORT) 
  4440.     Size, in bytes, of each DRAGITEM structure. 
  4441.  
  4442.  
  4443. ΓòÉΓòÉΓòÉ <hidden> DRAGINFO Parameter - usOperation ΓòÉΓòÉΓòÉ
  4444.  
  4445.  usOperation (USHORT) 
  4446.     Modified drag operations. 
  4447.  
  4448.     An application can define its own modified drag operations for use when 
  4449.     simulating a drop. These operations must have a value greater than 
  4450.     DO_UNKNOWN. Possible values are described in the following list: 
  4451.  
  4452.       DO_DEFAULT 
  4453.                     Execute the default drag operation. No modifier keys are 
  4454.                     pressed. 
  4455.       DO_COPY 
  4456.                     Execute a copy operation. The Ctrl key is pressed. 
  4457.       DO_LINK 
  4458.                     Execute a link operation. The Ctrl+Shift keys are pressed. 
  4459.       DO_MOVE 
  4460.                     Execute a move operation. The Shift key is pressed. 
  4461.       DO_UNKNOWN 
  4462.                     An undefined combination of modifier keys is pressed. 
  4463.  
  4464.  
  4465. ΓòÉΓòÉΓòÉ <hidden> DRAGINFO Parameter - hwndSource ΓòÉΓòÉΓòÉ
  4466.  
  4467.  hwndSource (HWND) 
  4468.     Window handle of the source of the drag operation. 
  4469.  
  4470.  
  4471. ΓòÉΓòÉΓòÉ <hidden> DRAGINFO Parameter - xDrop ΓòÉΓòÉΓòÉ
  4472.  
  4473.  xDrop (SHORT) 
  4474.     X-coordinate of drop point expressed in desktop coordinates. 
  4475.  
  4476.  
  4477. ΓòÉΓòÉΓòÉ <hidden> DRAGINFO Parameter - yDrop ΓòÉΓòÉΓòÉ
  4478.  
  4479.  yDrop (SHORT) 
  4480.     Y-coordinate of drop point expressed in desktop coordinates. 
  4481.  
  4482.  
  4483. ΓòÉΓòÉΓòÉ <hidden> DRAGINFO Parameter - cditem ΓòÉΓòÉΓòÉ
  4484.  
  4485.  cditem (USHORT) 
  4486.     Count of DRAGITEM structures. 
  4487.  
  4488.  
  4489. ΓòÉΓòÉΓòÉ <hidden> DRAGINFO Parameter - usReserved ΓòÉΓòÉΓòÉ
  4490.  
  4491.  usReserved (USHORT) 
  4492.     Reserved. 
  4493.  
  4494.  
  4495. ΓòÉΓòÉΓòÉ 2.17. DRAGITEM ΓòÉΓòÉΓòÉ
  4496.  
  4497. Drag-object structure. 
  4498.  
  4499. typedef struct _DRAGITEM {
  4500. HWND     hwndItem;           /*  Window handle of the source of the drag operation. */
  4501. ULONG    ulItemID;           /*  Information used by the source to identify the object being dragged. */
  4502. HSTR     hstrType;           /*  String handle of the object type. */
  4503. HSTR     hstrRMF;            /*  String handle of the rendering mechanism and format. */
  4504. HSTR     hstrContainerName;  /*  String handle of the name of the container holding the source object. */
  4505. HSTR     hstrSourceName;     /*  String handle of the name of the source object. */
  4506. HSTR     hstrTargetName;     /*  String handle of the suggested name of the object at the target. */
  4507. SHORT    cxOffset;           /*  X-offset from the pointer hot spot to the origin of the image that represents this object. */
  4508. SHORT    cyOffset;           /*  Y-offset from the pointer hot spot to the origin of the image that represents this object. */
  4509. USHORT   fsControl;          /*  Source-object control flags. */
  4510. USHORT   fsSupportedOps;     /*  Direct manipulation operations supported by the source object. */
  4511.  } DRAGITEM;
  4512.  
  4513. typedef DRAGITEM *PDRAGITEM;
  4514.  
  4515.  
  4516. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - hwndItem ΓòÉΓòÉΓòÉ
  4517.  
  4518.  hwndItem (HWND) 
  4519.     Window handle of the source of the drag operation. 
  4520.  
  4521.  
  4522. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - ulItemID ΓòÉΓòÉΓòÉ
  4523.  
  4524.  ulItemID (ULONG) 
  4525.     Information used by the source to identify the object being dragged. 
  4526.  
  4527.  
  4528. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - hstrType ΓòÉΓòÉΓòÉ
  4529.  
  4530.  hstrType (HSTR) 
  4531.     String handle of the object type. 
  4532.  
  4533.     The string handle must be created using the DrgAddStrHandle function. The 
  4534.     string is of the form: 
  4535.  
  4536.  
  4537.         type[,type...]
  4538.  
  4539.     The first type in the list must be the true type of the object. The 
  4540.     following types are used by the OS/2* shell: 
  4541.  
  4542.       DRT_ASM 
  4543.          Assembler code 
  4544.       DRT_BASIC 
  4545.          BASIC code 
  4546.       DRT_BINDATA 
  4547.          Binary data 
  4548.       DRT_BITMAP 
  4549.          Bit map 
  4550.       DRT_C 
  4551.          C code 
  4552.       DRT_COBOL 
  4553.          COBOL code 
  4554.       DRT_DLL 
  4555.          Dynamic link library 
  4556.       DRT_DOSCMD 
  4557.          DOS command file 
  4558.       DRT_EXE 
  4559.          Executable file 
  4560.       DRT_FONT 
  4561.          Font 
  4562.       DRT_FORTRAN 
  4563.          FORTRAN code 
  4564.       DRT_ICON 
  4565.          Icon 
  4566.       DRT_LIB 
  4567.          Library 
  4568.       DRT_METAFILE 
  4569.          Metafile 
  4570.       DRT_OS2CMD 
  4571.          OS/2 command file 
  4572.       DRT_PASCAL 
  4573.          Pascal code 
  4574.       DRT_RESOURCE 
  4575.          Resource file 
  4576.       DRT_TEXT 
  4577.          Text 
  4578.       DRT_UNKNOWN 
  4579.          Unknown type. 
  4580.  
  4581.  
  4582. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - hstrRMF ΓòÉΓòÉΓòÉ
  4583.  
  4584.  hstrRMF (HSTR) 
  4585.     String handle of the rendering mechanism and format. 
  4586.  
  4587.     The string handle must be created using the DrgAddStrHandle function. The 
  4588.     string is of the form: 
  4589.  
  4590.  
  4591.         mechfmt[,mechfmt...]
  4592.  
  4593.     where mechfmt can be in either of the following formats: 
  4594.  
  4595.    o  <mechanism(1),format(1)> 
  4596.    o  (mechanism(1)[, mechanism(n)...]) x (format(1)[,format(n)...]) 
  4597.  
  4598.     The first mechanism/format pair must be the native rendering mechanism and 
  4599.     format of the object. 
  4600.  
  4601.     Valid mechanisms are: 
  4602.  
  4603.       "DRM_DDE"           Dynamic data exchange 
  4604.  
  4605.       "DRM_OBJECT"        Item being dragged is a workplace object 
  4606.  
  4607.       "DRM_OS2FILE"       OS/2 file 
  4608.  
  4609.       "DRM_PRINT"         Object can be printed using direct manipulation. 
  4610.  
  4611.     Valid formats are: 
  4612.  
  4613.       "DRF_BITMAP"        OS/2 bit map 
  4614.  
  4615.       "DRF_DIB"           DIB 
  4616.  
  4617.       "DRF_DIF"           DIF 
  4618.  
  4619.       "DRF_DSPBITMAP"     Stream of bit-map bits 
  4620.  
  4621.       "DRF_METAFILE"      Metafile 
  4622.  
  4623.       "DRF_OEMTEXT"       OEM text 
  4624.  
  4625.       "DRF_OWNERDISPLAY"  Bit stream 
  4626.  
  4627.       "DRF_PTRPICT"       Printer picture 
  4628.  
  4629.       "DRF_RTF"           Rich text 
  4630.  
  4631.       "DRF_SYLK"          SYLK 
  4632.  
  4633.       "DRF_TEXT"          Null-terminated string 
  4634.  
  4635.       "DRF_TIFF"          TIFF 
  4636.  
  4637.       "DRF_UNKNOWN"       Unknown format. 
  4638.  
  4639.  
  4640. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - hstrContainerName ΓòÉΓòÉΓòÉ
  4641.  
  4642.  hstrContainerName (HSTR) 
  4643.     String handle of the name of the container holding the source object. 
  4644.  
  4645.     The string handle must be created using the DrgAddStrHandle function. 
  4646.  
  4647.  
  4648. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - hstrSourceName ΓòÉΓòÉΓòÉ
  4649.  
  4650.  hstrSourceName (HSTR) 
  4651.     String handle of the name of the source object. 
  4652.  
  4653.     The string handle must be created using the DrgAddStrHandle function. 
  4654.  
  4655.  
  4656. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - hstrTargetName ΓòÉΓòÉΓòÉ
  4657.  
  4658.  hstrTargetName (HSTR) 
  4659.     String handle of the suggested name of the object at the target. 
  4660.  
  4661.     It is the responsibility of the source of the drag operation to create this 
  4662.     string handle before calling DrgDrag. 
  4663.  
  4664.  
  4665. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - cxOffset ΓòÉΓòÉΓòÉ
  4666.  
  4667.  cxOffset (SHORT) 
  4668.     X-offset from the pointer hot spot to the origin of the image that 
  4669.     represents this object. 
  4670.  
  4671.     This value is copied from cxOffset in the DRAGIMAGE structure by DrgDrag. 
  4672.  
  4673.  
  4674. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - cyOffset ΓòÉΓòÉΓòÉ
  4675.  
  4676.  cyOffset (SHORT) 
  4677.     Y-offset from the pointer hot spot to the origin of the image that 
  4678.     represents this object. 
  4679.  
  4680.     This value is copied from cyOffset in the DRAGIMAGE structure by DrgDrag. 
  4681.  
  4682.  
  4683. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - fsControl ΓòÉΓòÉΓòÉ
  4684.  
  4685.  fsControl (USHORT) 
  4686.     Source-object control flags. 
  4687.  
  4688.       DC_OPEN 
  4689.          Object is open 
  4690.       DC_REF 
  4691.          Reference to another object 
  4692.       DC_GROUP 
  4693.          Group of objects 
  4694.       DC_CONTAINER 
  4695.          Container of other objects 
  4696.       DC_PREPARE 
  4697.          Source requires a DM_RENDERPREPARE message before it establishes a 
  4698.          data transfer conversation 
  4699.       DC_REMOVEABLEMEDIA 
  4700.          Object is on removable media, or object cannot be recovered after a 
  4701.          move operation. 
  4702.  
  4703.  
  4704. ΓòÉΓòÉΓòÉ <hidden> DRAGITEM Parameter - fsSupportedOps ΓòÉΓòÉΓòÉ
  4705.  
  4706.  fsSupportedOps (USHORT) 
  4707.     Direct manipulation operations supported by the source object. 
  4708.  
  4709.       DO_COPYABLE 
  4710.          Source supports DO_COPY 
  4711.       DO_LINKABLE 
  4712.          Source supports DO_LINK 
  4713.       DO_MOVEABLE 
  4714.          Source supports DO_MOVE. 
  4715.  
  4716.  
  4717. ΓòÉΓòÉΓòÉ 2.18. DRAGTRANSFER ΓòÉΓòÉΓòÉ
  4718.  
  4719. Drag-conversation structure. 
  4720.  
  4721. typedef struct _DRAGTRANSFER {
  4722. ULONG       cb;                /*  Size, in bytes, of the structure. */
  4723. HWND        hwndClient;        /*  Handle of the client window. */
  4724. PDRAGITEM   pditem;            /*  Pointer to the DRAGITEM structure that is to be rendered. */
  4725. HSTR        hstrSelectedRMF;   /*  String handle for the selected rendering mechanism and format for the transfer operation. */
  4726. HSTR        hstrRenderToName;  /*  String handle representing the name where the source places, and the target finds, the data that is rendered. */
  4727. ULONG       ulTargetInfo;      /*  Reserved. */
  4728. USHORT      usOperation;       /*  The operation. */
  4729. USHORT      fsReply;           /*  Reply flags. */
  4730.  } DRAGTRANSFER;
  4731.  
  4732. typedef DRAGTRANSFER *PDRAGTRANSFER;
  4733.  
  4734.  
  4735. ΓòÉΓòÉΓòÉ <hidden> DRAGTRANSFER Parameter - cb ΓòÉΓòÉΓòÉ
  4736.  
  4737.  cb (ULONG) 
  4738.     Size, in bytes, of the structure. 
  4739.  
  4740.  
  4741. ΓòÉΓòÉΓòÉ <hidden> DRAGTRANSFER Parameter - hwndClient ΓòÉΓòÉΓòÉ
  4742.  
  4743.  hwndClient (HWND) 
  4744.     Handle of the client window. 
  4745.  
  4746.     This can be the target window or a window that represents an object in a 
  4747.     container that was dropped on. 
  4748.  
  4749.  
  4750. ΓòÉΓòÉΓòÉ <hidden> DRAGTRANSFER Parameter - pditem ΓòÉΓòÉΓòÉ
  4751.  
  4752.  pditem (PDRAGITEM) 
  4753.     Pointer to the DRAGITEM structure that is to be rendered. 
  4754.  
  4755.     This structure must exist within the DRAGINFO structure that was passed in 
  4756.     the DM_DROP message. 
  4757.  
  4758.  
  4759. ΓòÉΓòÉΓòÉ <hidden> DRAGTRANSFER Parameter - hstrSelectedRMF ΓòÉΓòÉΓòÉ
  4760.  
  4761.  hstrSelectedRMF (HSTR) 
  4762.     String handle for the selected rendering mechanism and format for the 
  4763.     transfer operation. 
  4764.  
  4765.     This handle must be created using DrgAddStrHandle. The target is 
  4766.     responsible for deleting this handle when the conversation is complete. The 
  4767.     string is in the format:  <mechanism,format>. 
  4768.  
  4769.  
  4770. ΓòÉΓòÉΓòÉ <hidden> DRAGTRANSFER Parameter - hstrRenderToName ΓòÉΓòÉΓòÉ
  4771.  
  4772.  hstrRenderToName (HSTR) 
  4773.     String handle representing the name where the source places, and the target 
  4774.     finds, the data that is rendered. 
  4775.  
  4776.     The target is responsible for deleting this string handle when the 
  4777.     conversation terminates. The contents of this field vary according to the 
  4778.     rendering mechanism. See the hstrRMF field in DRAGITEM. 
  4779.  
  4780.       OS/2 File   The string handle represents the fully qualified name of the 
  4781.                   file where the rendering will be placed. 
  4782.       DDE         This field is not used. 
  4783.       Print       This field is not used. 
  4784.  
  4785.  
  4786. ΓòÉΓòÉΓòÉ <hidden> DRAGTRANSFER Parameter - ulTargetInfo ΓòÉΓòÉΓòÉ
  4787.  
  4788.  ulTargetInfo (ULONG) 
  4789.     Reserved. 
  4790.  
  4791.     Reserved for use by the target. The target can use this field for 
  4792.     information about the object and rendering operation. 
  4793.  
  4794.  
  4795. ΓòÉΓòÉΓòÉ <hidden> DRAGTRANSFER Parameter - usOperation ΓòÉΓòÉΓòÉ
  4796.  
  4797.  usOperation (USHORT) 
  4798.     The operation. 
  4799.  
  4800.     Values are: 
  4801.  
  4802.       DO_COPY 
  4803.                     Execute a copy operation. 
  4804.       DO_LINK 
  4805.                     Execute a link operation. 
  4806.       DO_MOVE 
  4807.                     Execute a move operation. 
  4808.       OTHER 
  4809.                     Execute an application-defined operation. 
  4810.  
  4811.  
  4812. ΓòÉΓòÉΓòÉ <hidden> DRAGTRANSFER Parameter - fsReply ΓòÉΓòÉΓòÉ
  4813.  
  4814.  fsReply (USHORT) 
  4815.     Reply flags. 
  4816.  
  4817.     Reply flags for the message. These flags can be set as follows: 
  4818.  
  4819.       DMFL_NATIVERENDER 
  4820.          The source does not support rendering for this object. A source should 
  4821.          not set this flag unless it provides sufficient information at the 
  4822.          time of the drop for the target to perform the rendering operation. 
  4823.          The target must send DM_ENDCONVERSATION to the source after carrying 
  4824.          out the rendering operation or when it elects not to do a native 
  4825.          rendering. 
  4826.  
  4827.       DMFL_RENDERRETRY 
  4828.          The source supports rendering for the object but does not support the 
  4829.          selected rendering mechanism and format. The target can try another 
  4830.          mechanism and format by sending another DM_RENDER message. If the 
  4831.          target does not retry, it must send a DM_RENDERCOMPLETE message to the 
  4832.          source. This flag is set in conjunction with the DMFL_NATIVERENDER 
  4833.          flag. 
  4834.  
  4835.  
  4836. ΓòÉΓòÉΓòÉ 2.19. DRIVDATA ΓòÉΓòÉΓòÉ
  4837.  
  4838. Driver-data structure. 
  4839.  
  4840. typedef struct _DRIVDATA {
  4841. LONG   cb;                /*  Length. */
  4842. LONG   lVersion;          /*  Version. */
  4843. CHAR   szDeviceName[32];  /*  Device name. */
  4844. CHAR   abGeneralData[1];  /*  General data. */
  4845.  } DRIVDATA;
  4846.  
  4847. typedef DRIVDATA *PDRIVDATA;
  4848.  
  4849.  
  4850. ΓòÉΓòÉΓòÉ <hidden> DRIVDATA Parameter - cb ΓòÉΓòÉΓòÉ
  4851.  
  4852.  cb (LONG) 
  4853.     Length. 
  4854.  
  4855.     The length of the structure. 
  4856.  
  4857.  
  4858. ΓòÉΓòÉΓòÉ <hidden> DRIVDATA Parameter - lVersion ΓòÉΓòÉΓòÉ
  4859.  
  4860.  lVersion (LONG) 
  4861.     Version. 
  4862.  
  4863.     The version number of the data. Version numbers are defined by particular 
  4864.     PM device drivers. 
  4865.  
  4866.  
  4867. ΓòÉΓòÉΓòÉ <hidden> DRIVDATA Parameter - szDeviceName[32] ΓòÉΓòÉΓòÉ
  4868.  
  4869.  szDeviceName[32] (CHAR) 
  4870.     Device name. 
  4871.  
  4872.     A string in a 32-byte field identifying the particular device (model 
  4873.     number, and so on). Again, valid values are defined by PM device drivers. 
  4874.  
  4875.  
  4876. ΓòÉΓòÉΓòÉ <hidden> DRIVDATA Parameter - abGeneralData[1] ΓòÉΓòÉΓòÉ
  4877.  
  4878.  abGeneralData[1] (CHAR) 
  4879.     General data. 
  4880.  
  4881.     Data as defined by the Presentation Manager device driver. 
  4882.  
  4883.     The data type of this field is defined by the Presentation Manager device 
  4884.     driver. It does not contain pointers, as these are not necessarily valid 
  4885.     when passed to the device driver. 
  4886.  
  4887.  
  4888. ΓòÉΓòÉΓòÉ 2.20. FATTRS ΓòÉΓòÉΓòÉ
  4889.  
  4890. Font-attributes structure. 
  4891.  
  4892. typedef struct _FATTRS {
  4893. USHORT   usRecordLength;        /*  Length of record. */
  4894. USHORT   fsSelection;           /*  Selection indicators. */
  4895. LONG     lMatch;                /*  Matched-font identity. */
  4896. CHAR     szFacename[FACESIZE];  /*  Typeface name. */
  4897. USHORT   idRegistry;            /*  Registry identifier. */
  4898. USHORT   usCodePage;            /*  Code page. */
  4899. LONG     lMaxBaselineExt;       /*  Maximum baseline extension. */
  4900. LONG     lAveCharWidth;         /*  Average character width. */
  4901. USHORT   fsType;                /*  Type indicators. */
  4902. USHORT   fsFontUse;             /*  Font-use indicators. */
  4903.  } FATTRS;
  4904.  
  4905. typedef FATTRS *PFATTRS;
  4906.  
  4907.  
  4908. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - usRecordLength ΓòÉΓòÉΓòÉ
  4909.  
  4910.  usRecordLength (USHORT) 
  4911.     Length of record. 
  4912.  
  4913.  
  4914. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - fsSelection ΓòÉΓòÉΓòÉ
  4915.  
  4916.  fsSelection (USHORT) 
  4917.     Selection indicators. 
  4918.  
  4919.     Flags causing the following features to be simulated by the system. 
  4920.  
  4921.     Note:  If an italic flag is applied to a font that is itself defined as 
  4922.            italic, the font is slanted further by italic simulation. 
  4923.  
  4924.     Underscore or strikeout lines are drawn using the appropriate attributes 
  4925.     (for example, color) from the character bundle (see the CHARBUNDLE 
  4926.     datatype), not the line bundle (see LINEBUNDLE). The width of the line, and 
  4927.     the vertical position of the line in font space, are determined by the 
  4928.     font. Horizontally, the line starts from a point in font space directly 
  4929.     above or below the start point of each character, and extends to a point 
  4930.     directly above or below the escapement point for that character. 
  4931.  
  4932.     For this purpose, the start and escapement points are those applicable to 
  4933.     left-to-right or right-to-left character directions (see 
  4934.     GpiSetCharDirection in Graphics Programming Interface Programming 
  4935.     Reference), even if the string is currently being drawn in a top-to-bottom 
  4936.     or bottom-to-top direction. 
  4937.  
  4938.     For left-to-right or right-to-left directions, any white space generated by 
  4939.     the character extra and character break extra attributes (see 
  4940.     GpiSetCharExtra and GpiSetCharBreakExtra in Graphics Programming Interface 
  4941.     Programming Reference), as well as increments provided by the vector of 
  4942.     increments on GpiCharStringPos and GpiCharStringPosAt, are also 
  4943.     underlined/overstruck, so that in these cases the line is continuous for 
  4944.     the string. 
  4945.  
  4946.       FATTR_SEL_ITALIC         Generate italic font. 
  4947.  
  4948.       FATTR_SEL_UNDERSCORE     Generate underscored font. 
  4949.  
  4950.       FATTR_SEL_BOLD           Generate bold font. (Note that the resulting 
  4951.                                characters are wider than those in the original 
  4952.                                font.) 
  4953.  
  4954.       FATTR_SEL_STRIKEOUT      Generate font with overstruck characters. 
  4955.  
  4956.       FATTR_SEL_OUTLINE        Use an outline font with hollow characters. If 
  4957.                                this flag is not set, outline font characters 
  4958.                                are filled. Setting this flag normally gives 
  4959.                                better performance, and for sufficiently small 
  4960.                                characters (depending on device resolution) 
  4961.                                there may be little visual difference. 
  4962.  
  4963.  
  4964. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - lMatch ΓòÉΓòÉΓòÉ
  4965.  
  4966.  lMatch (LONG) 
  4967.     Matched-font identity. 
  4968.  
  4969.  
  4970. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - szFacename[FACESIZE] ΓòÉΓòÉΓòÉ
  4971.  
  4972.  szFacename[FACESIZE] (CHAR) 
  4973.     Typeface name. 
  4974.  
  4975.     The typeface name of the font, for example, Tms Rmn. 
  4976.  
  4977.  
  4978. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - idRegistry ΓòÉΓòÉΓòÉ
  4979.  
  4980.  idRegistry (USHORT) 
  4981.     Registry identifier. 
  4982.  
  4983.     Font registry identifier (zero if unknown). 
  4984.  
  4985.  
  4986. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - usCodePage ΓòÉΓòÉΓòÉ
  4987.  
  4988.  usCodePage (USHORT) 
  4989.     Code page. 
  4990.  
  4991.     If zero, the current Gpi code page (see GpiSetCp in Graphics Programming 
  4992.     Interface Programming Reference) is used. A subsequent GpiSetCp function 
  4993.     changes the code page used for this logical font. 
  4994.  
  4995.  
  4996. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - lMaxBaselineExt ΓòÉΓòÉΓòÉ
  4997.  
  4998.  lMaxBaselineExt (LONG) 
  4999.     Maximum baseline extension. 
  5000.  
  5001.     For raster fonts, this should be the height of the required font, in world 
  5002.     coordinates. 
  5003.  
  5004.     For outline fonts, this should be zero. 
  5005.  
  5006.  
  5007. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - lAveCharWidth ΓòÉΓòÉΓòÉ
  5008.  
  5009.  lAveCharWidth (LONG) 
  5010.     Average character width. 
  5011.  
  5012.     For raster fonts, this should be the width of the required font, in world 
  5013.     coordinates. 
  5014.  
  5015.     For outline fonts, this should be zero. 
  5016.  
  5017.  
  5018. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - fsType ΓòÉΓòÉΓòÉ
  5019.  
  5020.  fsType (USHORT) 
  5021.     Type indicators. 
  5022.  
  5023.       FATTR_TYPE_KERNING       Enable kerning (PostScript** only). 
  5024.  
  5025.       FATTR_TYPE_MBCS          Font for mixed single- and double-byte code 
  5026.                                pages. 
  5027.  
  5028.       FATTR_TYPE_DBCS          Font for double-byte code pages. 
  5029.  
  5030.       FATTR_TYPE_ANTIALIASED   Antialiased font required. Only valid if 
  5031.                                supported by the device driver. 
  5032.  
  5033.  
  5034. ΓòÉΓòÉΓòÉ <hidden> FATTRS Parameter - fsFontUse ΓòÉΓòÉΓòÉ
  5035.  
  5036.  fsFontUse (USHORT) 
  5037.     Font-use indicators. 
  5038.  
  5039.     These flags indicate how the font is to be used. They affect presentation 
  5040.     speed and font quality. 
  5041.  
  5042.       FATTR_FONTUSE_NOMIX      Text is not mixed with graphics and can be 
  5043.                                written without regard to any interaction with 
  5044.                                graphics objects. 
  5045.  
  5046.       FATTR_FONTUSE_OUTLINE    Select an outline (vector) font. The font 
  5047.                                characters can be used as part of a path 
  5048.                                definition. If this flag is not set, an outline 
  5049.                                font might or might not be selected. If an 
  5050.                                outline font is selected, however, character 
  5051.                                widths are rounded to an integral number of 
  5052.                                pels. 
  5053.  
  5054.       FATTR_FONTUSE_TRANSFORMABLE Characters can be transformed (for example, 
  5055.                                scaled, rotated, or sheared). 
  5056.  
  5057.  
  5058. ΓòÉΓòÉΓòÉ 2.21. FDATE ΓòÉΓòÉΓòÉ
  5059.  
  5060. Date data structure for file-system functions. 
  5061.  
  5062. typedef struct _FDATE {
  5063. USHORT   day:5;    /*  Binary day for directory entry. */
  5064. USHORT   month:4;  /*  Binary month for directory entry. */
  5065. USHORT   year:7;   /*  The number of years since 1980 for this directory entry. */
  5066.  } FDATE;
  5067.  
  5068. typedef FDATE *PFDATE;
  5069.  
  5070.  
  5071. ΓòÉΓòÉΓòÉ <hidden> FDATE Parameter - day:5 ΓòÉΓòÉΓòÉ
  5072.  
  5073.  day:5 (USHORT) 
  5074.     Binary day for directory entry. 
  5075.  
  5076.  
  5077. ΓòÉΓòÉΓòÉ <hidden> FDATE Parameter - month:4 ΓòÉΓòÉΓòÉ
  5078.  
  5079.  month:4 (USHORT) 
  5080.     Binary month for directory entry. 
  5081.  
  5082.  
  5083. ΓòÉΓòÉΓòÉ <hidden> FDATE Parameter - year:7 ΓòÉΓòÉΓòÉ
  5084.  
  5085.  year:7 (USHORT) 
  5086.     The number of years since 1980 for this directory entry. 
  5087.  
  5088.  
  5089. ΓòÉΓòÉΓòÉ 2.22. FEA2 ΓòÉΓòÉΓòÉ
  5090.  
  5091. 32-bit FEA2 data structure. 
  5092.  
  5093. The data structure defines the format for setting the full extended attributes 
  5094. in the file. 
  5095.  
  5096. typedef struct _FEA2 {
  5097. ULONG    oNextEntryOffset;  /*  Offset to next entry. */
  5098. BYTE     fEA;               /*  Extended attributes flag. */
  5099. BYTE     cbName;            /*  Length of szName, not including NULL. */
  5100. USHORT   cbValue;           /*  Value length. */
  5101. CHAR     szName[1];         /*  Extended attribute name. */
  5102.  } FEA2;
  5103.  
  5104. typedef FEA2 *PFEA2;
  5105.  
  5106. Extended attributes (EAs) are non-critical by default. A non-critical EA is one 
  5107. that is not necessary to the functionality of the application. If a 
  5108. non-critical EA is lost, the system continues to operate correctly. For 
  5109. example, losing the icons associated with data files does not generally cause 
  5110. any ill effect other than the inability to show the icon. 
  5111.  
  5112. A critical extended attribute is one which is necessary for the correct 
  5113. operation of the operating system or of a particular operation. EAs should be 
  5114. marked as critical if their loss would cause the system or program to perform 
  5115. incorrectly. For example, a mail program might store mail headers in EAs. The 
  5116. loss of the header from a message would normally render the mail program unable 
  5117. to further use that message. This would be unacceptable, so the mail program 
  5118. should mark this EA as critical. 
  5119.  
  5120.  
  5121. ΓòÉΓòÉΓòÉ <hidden> FEA2 Parameter - oNextEntryOffset ΓòÉΓòÉΓòÉ
  5122.  
  5123.  oNextEntryOffset (ULONG) 
  5124.     Offset to next entry. 
  5125.  
  5126.  
  5127. ΓòÉΓòÉΓòÉ <hidden> FEA2 Parameter - fEA ΓòÉΓòÉΓòÉ
  5128.  
  5129.  fEA (BYTE) 
  5130.     Extended attributes flag. 
  5131.  
  5132.       FEA_NEEDEA 
  5133.          Extended attributes are critical. 
  5134.  
  5135.          If this flag is set, this file cannot be copied to a file system that 
  5136.          does not support extended attributes. This flag should only be set if 
  5137.          extended attributes are critical to the processing of this file. 
  5138.  
  5139.       0 
  5140.          Extended attributes are not critical. 
  5141.  
  5142.  
  5143. ΓòÉΓòÉΓòÉ <hidden> FEA2 Parameter - cbName ΓòÉΓòÉΓòÉ
  5144.  
  5145.  cbName (BYTE) 
  5146.     Length of szName, not including NULL. 
  5147.  
  5148.     This value must be greater than 0. 
  5149.  
  5150.  
  5151. ΓòÉΓòÉΓòÉ <hidden> FEA2 Parameter - cbValue ΓòÉΓòÉΓòÉ
  5152.  
  5153.  cbValue (USHORT) 
  5154.     Value length. 
  5155.  
  5156.     Sending an EA with cbValue set to 0 in the FEA2 data structure causes that 
  5157.     attribute to be deleted, if possible. Receiving an EA with cbValue set to 0 
  5158.     in the FEA2 data structure indicates that the attribute is not present. 
  5159.  
  5160.  
  5161. ΓòÉΓòÉΓòÉ <hidden> FEA2 Parameter - szName[1] ΓòÉΓòÉΓòÉ
  5162.  
  5163.  szName[1] (CHAR) 
  5164.     Extended attribute name. 
  5165.  
  5166.  
  5167. ΓòÉΓòÉΓòÉ 2.23. FEA2LIST ΓòÉΓòÉΓòÉ
  5168.  
  5169. FEA2 data structure. 
  5170.  
  5171. typedef struct _FEA2LIST {
  5172. ULONG   cbList;   /*  Total bytes of structure including full list. */
  5173. FEA2    list[1];  /*  Variable-length FEA2 structures. */
  5174.  } FEA2LIST;
  5175.  
  5176. typedef FEA2LIST *PFEA2LIST;
  5177.  
  5178.  
  5179. ΓòÉΓòÉΓòÉ <hidden> FEA2LIST Parameter - cbList ΓòÉΓòÉΓòÉ
  5180.  
  5181.  cbList (ULONG) 
  5182.     Total bytes of structure including full list. 
  5183.  
  5184.  
  5185. ΓòÉΓòÉΓòÉ <hidden> FEA2LIST Parameter - list[1] ΓòÉΓòÉΓòÉ
  5186.  
  5187.  list[1] (FEA2) 
  5188.     Variable-length FEA2 structures. 
  5189.  
  5190.  
  5191. ΓòÉΓòÉΓòÉ 2.24. FIELDINFO ΓòÉΓòÉΓòÉ
  5192.  
  5193. Structure that contains information about column data in the details view of 
  5194. the container control. The details view displays each FIELDINFO structure as a 
  5195. column of data that contains specific information about each container record. 
  5196. For example, one FIELDINFO structure, or column, might contain icons or bit 
  5197. maps that represent each container record. Another FIELDINFO structure might 
  5198. contain the date or time that each container record was created. 
  5199.  
  5200. typedef struct _FIELDINFO {
  5201. ULONG                 cb;              /*  Structure size. */
  5202. ULONG                 flData;          /*  Data attributes. */
  5203. ULONG                 flTitle;         /*  Column heading attributes. */
  5204. PVOID                 pTitleData;      /*  Column heading data. */
  5205. ULONG                 offStruct;       /*  Structure offset. */
  5206. PVOID                 pUserData;       /*  Pointer to user data. */
  5207. struct _FIELDINFO    *pNextFieldInfo;  /*  Pointer to the next linked FIELDINFO data structure. */
  5208. ULONG                 cxWidth;         /*  Column width. */
  5209.  } FIELDINFO;
  5210.  
  5211. typedef FIELDINFO *PFIELDINFO;
  5212.  
  5213.  
  5214. ΓòÉΓòÉΓòÉ <hidden> FIELDINFO Parameter - cb ΓòÉΓòÉΓòÉ
  5215.  
  5216.  cb (ULONG) 
  5217.     Structure size. 
  5218.  
  5219.     The size (in bytes) of the FIELDINFO structure. 
  5220.  
  5221.  
  5222. ΓòÉΓòÉΓòÉ <hidden> FIELDINFO Parameter - flData ΓòÉΓòÉΓòÉ
  5223.  
  5224.  flData (ULONG) 
  5225.     Data attributes. 
  5226.  
  5227.     Attributes of the data in a field. 
  5228.  
  5229.    o  Specify one of the following for each column to choose the type of data 
  5230.       that is displayed in each column: 
  5231.  
  5232.            CFA_BITMAPORICON 
  5233.               The column contains bit-map or icon data. 
  5234.  
  5235.            CFA_DATE 
  5236.               The data in the column is displayed in date format. National 
  5237.               Language Support (NLS) is enabled for date format. Use the data 
  5238.               structure described in CDATE 
  5239.  
  5240.            CFA_STRING 
  5241.               Character or text data is displayed in this column. 
  5242.  
  5243.            CFA_TIME 
  5244.               The data in the column is displayed in time format. National 
  5245.               Language Support (NLS) is enabled for time format. Use the data 
  5246.               structure described in CTIME. 
  5247.  
  5248.            CFA_ULONG 
  5249.               Unsigned number data is displayed in this column. National 
  5250.               Language Support (NLS) is enabled for number format. 
  5251.  
  5252.    o  Specify any or all of the following column attributes: 
  5253.  
  5254.            CFA_FIREADONLY 
  5255.               Prevents text in a FIELDINFO data structure (text in a column) 
  5256.               from being edited directly. This attribute applies only to 
  5257.               columns for which the CFA_STRING attribute has been specified. 
  5258.  
  5259.            CFA_HORZSEPARATOR 
  5260.               A horizontal separator is provided beneath column headings. 
  5261.  
  5262.            CFA_INVISIBLE 
  5263.               Invisible container column. The default is visible. 
  5264.  
  5265.            CFA_OWNER 
  5266.               Ownerdraw is enabled for this container column. 
  5267.  
  5268.            CFA_SEPARATOR 
  5269.               A vertical separator is drawn after this column. 
  5270.  
  5271.    o  Specify one of the following for each column to vertically position data 
  5272.       in that column: 
  5273.  
  5274.            CFA_BOTTOM 
  5275.               Bottom-justifies field data. 
  5276.  
  5277.            CFA_TOP 
  5278.               Top-justifies field data. 
  5279.  
  5280.            CFA_VCENTER 
  5281.               Vertically centers field data. This is the default. 
  5282.  
  5283.    o  Specify one of the following for each column to horizontally position 
  5284.       data in that column. These attributes can be combined with the attributes 
  5285.       used for vertical positioning of column data by using an OR operator (|). 
  5286.  
  5287.            CFA_CENTER 
  5288.               Horizontally centers field data. 
  5289.  
  5290.            CFA_LEFT 
  5291.               Left-justifies field data. This is the default. 
  5292.  
  5293.            CFA_RIGHT 
  5294.               Right-justifies field data. 
  5295.  
  5296.  
  5297. ΓòÉΓòÉΓòÉ <hidden> FIELDINFO Parameter - flTitle ΓòÉΓòÉΓòÉ
  5298.  
  5299.  flTitle (ULONG) 
  5300.     Column heading attributes. 
  5301.  
  5302.    o  Specify the following if icon or bit-map data is to be displayed in the 
  5303.       column heading: 
  5304.  
  5305.            CFA_BITMAPORICON 
  5306.               The column heading contains icon or bit-map data. If 
  5307.               CFA_BITMAPORICON is not specified, any data that is assigned to a 
  5308.               column heading is assumed to be character or text data. 
  5309.  
  5310.    o  Specify the following to prevent direct editing of a column heading: 
  5311.  
  5312.            CFA_FITITLEREADONLY 
  5313.               Prevents a column heading from being edited directly. 
  5314.  
  5315.    o  Specify one of the following for each column heading to vertically 
  5316.       position data in that column heading: 
  5317.  
  5318.            CFA_TOP 
  5319.               Top-justifies column headings. 
  5320.            CFA_BOTTOM 
  5321.               Bottom-justifies column headings. 
  5322.            CFA_VCENTER 
  5323.               Vertically centers column headings. This is the default. 
  5324.  
  5325.    o  Specify one of the following for each column heading to horizontally 
  5326.       position data in that column heading. These attributes can be combined 
  5327.       with the attributes used for vertical positioning of column heading data 
  5328.       by using an OR operator (|). 
  5329.  
  5330.            CFA_CENTER 
  5331.               Horizontally centers column headings. 
  5332.            CFA_LEFT 
  5333.               Left-justifies column headings. This is the default. 
  5334.            CFA_RIGHT 
  5335.               Right-justifies column headings. 
  5336.  
  5337.  
  5338. ΓòÉΓòÉΓòÉ <hidden> FIELDINFO Parameter - pTitleData ΓòÉΓòÉΓòÉ
  5339.  
  5340.  pTitleData (PVOID) 
  5341.     Column heading data. 
  5342.  
  5343.     Column heading data, which can be a text string or an icon or bit map. The 
  5344.     default is a text string. If the flTitle field is set to the 
  5345.     CFA_BITMAPORICON attribute, this must be an icon or bit map. 
  5346.  
  5347.  
  5348. ΓòÉΓòÉΓòÉ <hidden> FIELDINFO Parameter - offStruct ΓòÉΓòÉΓòÉ
  5349.  
  5350.  offStruct (ULONG) 
  5351.     Structure offset. 
  5352.  
  5353.     Offset from the beginning of a RECORDCORE structure to the data that is 
  5354.     displayed in this column. 
  5355.  
  5356.     Note:  If the CCS_MINIRECORDCORE style bit is specified when a container is 
  5357.     created, then MINIRECORDCORE should be used instead of RECORDCORE and 
  5358.     PMINIRECORDCORE should be used instead of PRECORDCORE in all applicable 
  5359.     data structures and messages. 
  5360.  
  5361.  
  5362. ΓòÉΓòÉΓòÉ <hidden> FIELDINFO Parameter - pUserData ΓòÉΓòÉΓòÉ
  5363.  
  5364.  pUserData (PVOID) 
  5365.     Pointer to user data. 
  5366.  
  5367.  
  5368. ΓòÉΓòÉΓòÉ <hidden> FIELDINFO Parameter - pNextFieldInfo ΓòÉΓòÉΓòÉ
  5369.  
  5370.  pNextFieldInfo (struct _FIELDINFO *) 
  5371.     Pointer to the next linked FIELDINFO data structure. 
  5372.  
  5373.  
  5374. ΓòÉΓòÉΓòÉ <hidden> FIELDINFO Parameter - cxWidth ΓòÉΓòÉΓòÉ
  5375.  
  5376.  cxWidth (ULONG) 
  5377.     Column width. 
  5378.  
  5379.     Used to specify the width of a column. The default is an automatically 
  5380.     sized column that is always the width of its widest element. If this field 
  5381.     is set and the data is too wide, the data is truncated. 
  5382.  
  5383.  
  5384. ΓòÉΓòÉΓòÉ 2.25. FILEFINDBUF4 ΓòÉΓòÉΓòÉ
  5385.  
  5386. 32-bit level 2 information (used with EAs). 
  5387.  
  5388. typedef struct _FILEFINDBUF4 {
  5389. ULONG   oNextEntryOffset;         /*  Offset of next entry. */
  5390. FDATE   fdateCreation;            /*  Date of file creation. */
  5391. FTIME   ftimeCreation;            /*  Time of file creation. */
  5392. FDATE   fdateLastAccess;          /*  Date of last access. */
  5393. FTIME   ftimeLastAccess;          /*  Time of last access. */
  5394. FDATE   fdateLastWrite;           /*  Date of last write. */
  5395. FTIME   ftimeLastWrite;           /*  Time of last write. */
  5396. ULONG   cbFile;                   /*  Size of file. */
  5397. ULONG   cbFileAlloc;              /*  Allocated size. */
  5398. ULONG   attrFile;                 /*  File attributes. */
  5399. ULONG   cbList;                   /*  Size of the file's extended attributes. */
  5400. UCHAR   cchName;                  /*  Length of file name. */
  5401. CHAR    achName[CCHMAXPATHCOMP];  /*  File name including null terminator. */
  5402.  } FILEFINDBUF4;
  5403.  
  5404. typedef FILEFINDBUF4 *PFILEFINDBUF4;
  5405.  
  5406.  
  5407. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - oNextEntryOffset ΓòÉΓòÉΓòÉ
  5408.  
  5409.  oNextEntryOffset (ULONG) 
  5410.     Offset of next entry. 
  5411.  
  5412.  
  5413. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - fdateCreation ΓòÉΓòÉΓòÉ
  5414.  
  5415.  fdateCreation (FDATE) 
  5416.     Date of file creation. 
  5417.  
  5418.  
  5419. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - ftimeCreation ΓòÉΓòÉΓòÉ
  5420.  
  5421.  ftimeCreation (FTIME) 
  5422.     Time of file creation. 
  5423.  
  5424.  
  5425. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - fdateLastAccess ΓòÉΓòÉΓòÉ
  5426.  
  5427.  fdateLastAccess (FDATE) 
  5428.     Date of last access. 
  5429.  
  5430.  
  5431. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - ftimeLastAccess ΓòÉΓòÉΓòÉ
  5432.  
  5433.  ftimeLastAccess (FTIME) 
  5434.     Time of last access. 
  5435.  
  5436.  
  5437. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - fdateLastWrite ΓòÉΓòÉΓòÉ
  5438.  
  5439.  fdateLastWrite (FDATE) 
  5440.     Date of last write. 
  5441.  
  5442.  
  5443. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - ftimeLastWrite ΓòÉΓòÉΓòÉ
  5444.  
  5445.  ftimeLastWrite (FTIME) 
  5446.     Time of last write. 
  5447.  
  5448.  
  5449. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - cbFile ΓòÉΓòÉΓòÉ
  5450.  
  5451.  cbFile (ULONG) 
  5452.     Size of file. 
  5453.  
  5454.  
  5455. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - cbFileAlloc ΓòÉΓòÉΓòÉ
  5456.  
  5457.  cbFileAlloc (ULONG) 
  5458.     Allocated size. 
  5459.  
  5460.  
  5461. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - attrFile ΓòÉΓòÉΓòÉ
  5462.  
  5463.  attrFile (ULONG) 
  5464.     File attributes. 
  5465.  
  5466.  
  5467. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - cbList ΓòÉΓòÉΓòÉ
  5468.  
  5469.  cbList (ULONG) 
  5470.     Size of the file's extended attributes. 
  5471.  
  5472.     The size is measured in bytes and is the size of the file's entire extended 
  5473.     attribute set on the disk. 
  5474.  
  5475.  
  5476. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - cchName ΓòÉΓòÉΓòÉ
  5477.  
  5478.  cchName (UCHAR) 
  5479.     Length of file name. 
  5480.  
  5481.  
  5482. ΓòÉΓòÉΓòÉ <hidden> FILEFINDBUF4 Parameter - achName[CCHMAXPATHCOMP] ΓòÉΓòÉΓòÉ
  5483.  
  5484.  achName[CCHMAXPATHCOMP] (CHAR) 
  5485.     File name including null terminator. 
  5486.  
  5487.  
  5488. ΓòÉΓòÉΓòÉ 2.26. FIXED ΓòÉΓòÉΓòÉ
  5489.  
  5490. Signed-integer fraction (16:16). This can be treated as a LONG where the value 
  5491. has been multiplied by 65 536. 
  5492.  
  5493. typedef LONG FIXED;
  5494.  
  5495.  
  5496. ΓòÉΓòÉΓòÉ 2.27. FTIME ΓòÉΓòÉΓòÉ
  5497.  
  5498. Time data structure for file-system functions. 
  5499.  
  5500. typedef struct _FTIME {
  5501. USHORT   twosecs:5;  /*  Binary number of two-second increments. */
  5502. USHORT   minutes:6;  /*  Binary number of minutes. */
  5503. USHORT   hours:5;    /*  Binary number of hours. */
  5504.  } FTIME;
  5505.  
  5506. typedef FTIME *PFTIME;
  5507.  
  5508.  
  5509. ΓòÉΓòÉΓòÉ <hidden> FTIME Parameter - twosecs:5 ΓòÉΓòÉΓòÉ
  5510.  
  5511.  twosecs:5 (USHORT) 
  5512.     Binary number of two-second increments. 
  5513.  
  5514.  
  5515. ΓòÉΓòÉΓòÉ <hidden> FTIME Parameter - minutes:6 ΓòÉΓòÉΓòÉ
  5516.  
  5517.  minutes:6 (USHORT) 
  5518.     Binary number of minutes. 
  5519.  
  5520.  
  5521. ΓòÉΓòÉΓòÉ <hidden> FTIME Parameter - hours:5 ΓòÉΓòÉΓòÉ
  5522.  
  5523.  hours:5 (USHORT) 
  5524.     Binary number of hours. 
  5525.  
  5526.  
  5527. ΓòÉΓòÉΓòÉ 2.28. HAB ΓòÉΓòÉΓòÉ
  5528.  
  5529. Anchor-block handle. 
  5530.  
  5531. typedef LHANDLE HAB;
  5532.  
  5533.  
  5534. ΓòÉΓòÉΓòÉ 2.29. HBITMAP ΓòÉΓòÉΓòÉ
  5535.  
  5536. Bit-map handle. 
  5537.  
  5538. typedef LHANDLE HBITMAP;
  5539.  
  5540.  
  5541. ΓòÉΓòÉΓòÉ 2.30. HCINFO ΓòÉΓòÉΓòÉ
  5542.  
  5543. Hardcopy-capabilities structure. 
  5544.  
  5545. typedef struct _HCINFO {
  5546. CHAR   szFormname[32];  /*  Form name. */
  5547. LONG   cx;              /*  Width (left-to-right) in millimeters. */
  5548. LONG   cy;              /*  Height (top-to-bottom) in millimeters. */
  5549. LONG   xLeftClip;       /*  Left-clip limit in millimeters. */
  5550. LONG   yBottomClip;     /*  Bottom-clip limit in millimeters. */
  5551. LONG   xRightClip;      /*  Right-clip limit in millimeters. */
  5552. LONG   yTopClip;        /*  Top-clip limit in millimeters. */
  5553. LONG   xPels;           /*  Number of pels between left-clip and right-clip limits. */
  5554. LONG   yPels;           /*  Number of pels between bottom-clip and top-clip limits. */
  5555. LONG   flAttributes;    /*  Attributes of the form identifier. */
  5556.  } HCINFO;
  5557.  
  5558. typedef HCINFO *PHCINFO;
  5559.  
  5560.  
  5561. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - szFormname[32] ΓòÉΓòÉΓòÉ
  5562.  
  5563.  szFormname[32] (CHAR) 
  5564.     Form name. 
  5565.  
  5566.  
  5567. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - cx ΓòÉΓòÉΓòÉ
  5568.  
  5569.  cx (LONG) 
  5570.     Width (left-to-right) in millimeters. 
  5571.  
  5572.  
  5573. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - cy ΓòÉΓòÉΓòÉ
  5574.  
  5575.  cy (LONG) 
  5576.     Height (top-to-bottom) in millimeters. 
  5577.  
  5578.  
  5579. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - xLeftClip ΓòÉΓòÉΓòÉ
  5580.  
  5581.  xLeftClip (LONG) 
  5582.     Left-clip limit in millimeters. 
  5583.  
  5584.  
  5585. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - yBottomClip ΓòÉΓòÉΓòÉ
  5586.  
  5587.  yBottomClip (LONG) 
  5588.     Bottom-clip limit in millimeters. 
  5589.  
  5590.  
  5591. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - xRightClip ΓòÉΓòÉΓòÉ
  5592.  
  5593.  xRightClip (LONG) 
  5594.     Right-clip limit in millimeters. 
  5595.  
  5596.  
  5597. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - yTopClip ΓòÉΓòÉΓòÉ
  5598.  
  5599.  yTopClip (LONG) 
  5600.     Top-clip limit in millimeters. 
  5601.  
  5602.  
  5603. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - xPels ΓòÉΓòÉΓòÉ
  5604.  
  5605.  xPels (LONG) 
  5606.     Number of pels between left-clip and right-clip limits. 
  5607.  
  5608.  
  5609. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - yPels ΓòÉΓòÉΓòÉ
  5610.  
  5611.  yPels (LONG) 
  5612.     Number of pels between bottom-clip and top-clip limits. 
  5613.  
  5614.  
  5615. ΓòÉΓòÉΓòÉ <hidden> HCINFO Parameter - flAttributes ΓòÉΓòÉΓòÉ
  5616.  
  5617.  flAttributes (LONG) 
  5618.     Attributes of the form identifier. 
  5619.  
  5620.       HCAPS_SELECTABLE    The form is installed on the printer as given by the 
  5621.                           printer properties dialog. It is available from an 
  5622.                           alternate form source without operator intervention. 
  5623.                           If the form does not have this bit set and is used 
  5624.                           (if the user selects it), a "forms mismatch" error is 
  5625.                           generated by the printer object. 
  5626.  
  5627.       HCAPS_CURRENT       The form is the one currently selected by the 
  5628.                           DevOpenDC DEVOPENSTRUC pdriv field (the job 
  5629.                           properties). 
  5630.  
  5631.  
  5632. ΓòÉΓòÉΓòÉ 2.31. HFIND ΓòÉΓòÉΓòÉ
  5633.  
  5634. Handle associated with a wpclsFindObjectFirst request. 
  5635.  
  5636. typedef LHANDLE HFIND;
  5637.  
  5638.  
  5639. ΓòÉΓòÉΓòÉ 2.32. HMODULE ΓòÉΓòÉΓòÉ
  5640.  
  5641. Module handle. 
  5642.  
  5643. typedef LHANDLE HMODULE;
  5644.  
  5645.  
  5646. ΓòÉΓòÉΓòÉ 2.33. HMQ ΓòÉΓòÉΓòÉ
  5647.  
  5648. Message-queue handle. 
  5649.  
  5650. typedef LHANDLE HMQ;
  5651.  
  5652.  
  5653. ΓòÉΓòÉΓòÉ 2.34. HOBJECT ΓòÉΓòÉΓòÉ
  5654.  
  5655. Workplace object handle. 
  5656.  
  5657. typedef LHANDLE HOBJECT;
  5658.  
  5659.  
  5660. ΓòÉΓòÉΓòÉ 2.35. HPOINTER ΓòÉΓòÉΓòÉ
  5661.  
  5662. Pointer handle. 
  5663.  
  5664. typedef LHANDLE HPOINTER;
  5665.  
  5666.  
  5667. ΓòÉΓòÉΓòÉ 2.36. HPS ΓòÉΓòÉΓòÉ
  5668.  
  5669. Presentation-space handle. 
  5670.  
  5671. typedef LHANDLE HPS;
  5672.  
  5673.  
  5674. ΓòÉΓòÉΓòÉ 2.37. HSTR ΓòÉΓòÉΓòÉ
  5675.  
  5676. String handle. 
  5677.  
  5678. typedef LHANDLE HSTR;
  5679.  
  5680.  
  5681. ΓòÉΓòÉΓòÉ 2.38. HWND ΓòÉΓòÉΓòÉ
  5682.  
  5683. Window handle. 
  5684.  
  5685. typedef LHANDLE HWND;
  5686.  
  5687.  
  5688. ΓòÉΓòÉΓòÉ 2.39. ICONINFO ΓòÉΓòÉΓòÉ
  5689.  
  5690. Icon information data structure. 
  5691.  
  5692. typedef struct _ICONINFO {
  5693. ULONG     cb;           /*  Length of the ICONINFO structure. */
  5694. ULONG     fFormat;      /*  Indicates where the icon resides. */
  5695. PSZ       pszFileName;  /*  Name of the file containing icon data. */
  5696. HMODULE   hmod;         /*  Module containing the the icon resource. */
  5697. ULONG     resid;        /*  Identity of the icon resource. */
  5698. ULONG     cbIconData;   /*  Length of the icon data in bytes. */
  5699. PVOID     pIconData;    /*  Pointer to the buffer containing icon data. */
  5700.  } ICONINFO;
  5701.  
  5702. typedef ICONINFO *PICONINFO;
  5703.  
  5704.  
  5705. ΓòÉΓòÉΓòÉ <hidden> ICONINFO Parameter - cb ΓòÉΓòÉΓòÉ
  5706.  
  5707.  cb (ULONG) 
  5708.     Length of the ICONINFO structure. 
  5709.  
  5710.  
  5711. ΓòÉΓòÉΓòÉ <hidden> ICONINFO Parameter - fFormat ΓòÉΓòÉΓòÉ
  5712.  
  5713.  fFormat (ULONG) 
  5714.     Indicates where the icon resides. 
  5715.  
  5716.     Possible values are: 
  5717.  
  5718.       ICON_FILE 
  5719.          Icon file supplied. 
  5720.       ICON_RESOURCE 
  5721.          Icon resource supplied. 
  5722.       ICON_DATA 
  5723.          Icon data supplied. 
  5724.       ICON_CLEAR 
  5725.          Go back to default icon. 
  5726.  
  5727.  
  5728. ΓòÉΓòÉΓòÉ <hidden> ICONINFO Parameter - pszFileName ΓòÉΓòÉΓòÉ
  5729.  
  5730.  pszFileName (PSZ) 
  5731.     Name of the file containing icon data. 
  5732.  
  5733.     This value is ignored if fFormat is not equal to ICON_FILE. 
  5734.  
  5735.  
  5736. ΓòÉΓòÉΓòÉ <hidden> ICONINFO Parameter - hmod ΓòÉΓòÉΓòÉ
  5737.  
  5738.  hmod (HMODULE) 
  5739.     Module containing the the icon resource. 
  5740.  
  5741.     This value is ignored if fFormat is not equal to ICON_RESOURCE. 
  5742.  
  5743.  
  5744. ΓòÉΓòÉΓòÉ <hidden> ICONINFO Parameter - resid ΓòÉΓòÉΓòÉ
  5745.  
  5746.  resid (ULONG) 
  5747.     Identity of the icon resource. 
  5748.  
  5749.     This value is ignored if fFormat is not equal to ICON_RESOURCE. 
  5750.  
  5751.  
  5752. ΓòÉΓòÉΓòÉ <hidden> ICONINFO Parameter - cbIconData ΓòÉΓòÉΓòÉ
  5753.  
  5754.  cbIconData (ULONG) 
  5755.     Length of the icon data in bytes. 
  5756.  
  5757.     This value is ignored if fFormat is not equal to ICON_DATA. 
  5758.  
  5759.  
  5760. ΓòÉΓòÉΓòÉ <hidden> ICONINFO Parameter - pIconData ΓòÉΓòÉΓòÉ
  5761.  
  5762.  pIconData (PVOID) 
  5763.     Pointer to the buffer containing icon data. 
  5764.  
  5765.     This value is ignored if fFormat is not equal to ICON_DATA. 
  5766.  
  5767.  
  5768. ΓòÉΓòÉΓòÉ 2.40. LHANDLE ΓòÉΓòÉΓòÉ
  5769.  
  5770. The handle of a resource. 
  5771.  
  5772. typedef unsigned long LHANDLE;
  5773.  
  5774.  
  5775. ΓòÉΓòÉΓòÉ 2.41. LINEBUNDLE ΓòÉΓòÉΓòÉ
  5776.  
  5777. Line-attributes bundle structure. 
  5778.  
  5779. typedef struct _LINEBUNDLE {
  5780. LONG     lColor;         /*  Line foreground color. */
  5781. LONG     lBackColor;     /*  Line background color. */
  5782. USHORT   usMixMode;      /*  Line foreground-mix mode. */
  5783. USHORT   usBackMixMode;  /*  Line background-mix mode. */
  5784. FIXED    fxWidth;        /*  Line width. */
  5785. LONG     lGeomWidth;     /*  Geometric line width. */
  5786. USHORT   usType;         /*  Line type. */
  5787. USHORT   usEnd;          /*  Line end. */
  5788. USHORT   usJoin;         /*  Line join. */
  5789. USHORT   usReserved;     /*  Reserved. */
  5790.  } LINEBUNDLE;
  5791.  
  5792. typedef LINEBUNDLE *PLINEBUNDLE;
  5793.  
  5794.  
  5795. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - lColor ΓòÉΓòÉΓòÉ
  5796.  
  5797.  lColor (LONG) 
  5798.     Line foreground color. 
  5799.  
  5800.  
  5801. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - lBackColor ΓòÉΓòÉΓòÉ
  5802.  
  5803.  lBackColor (LONG) 
  5804.     Line background color. 
  5805.  
  5806.  
  5807. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - usMixMode ΓòÉΓòÉΓòÉ
  5808.  
  5809.  usMixMode (USHORT) 
  5810.     Line foreground-mix mode. 
  5811.  
  5812.  
  5813. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - usBackMixMode ΓòÉΓòÉΓòÉ
  5814.  
  5815.  usBackMixMode (USHORT) 
  5816.     Line background-mix mode. 
  5817.  
  5818.  
  5819. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - fxWidth ΓòÉΓòÉΓòÉ
  5820.  
  5821.  fxWidth (FIXED) 
  5822.     Line width. 
  5823.  
  5824.  
  5825. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - lGeomWidth ΓòÉΓòÉΓòÉ
  5826.  
  5827.  lGeomWidth (LONG) 
  5828.     Geometric line width. 
  5829.  
  5830.  
  5831. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - usType ΓòÉΓòÉΓòÉ
  5832.  
  5833.  usType (USHORT) 
  5834.     Line type. 
  5835.  
  5836.  
  5837. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - usEnd ΓòÉΓòÉΓòÉ
  5838.  
  5839.  usEnd (USHORT) 
  5840.     Line end. 
  5841.  
  5842.  
  5843. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - usJoin ΓòÉΓòÉΓòÉ
  5844.  
  5845.  usJoin (USHORT) 
  5846.     Line join. 
  5847.  
  5848.  
  5849. ΓòÉΓòÉΓòÉ <hidden> LINEBUNDLE Parameter - usReserved ΓòÉΓòÉΓòÉ
  5850.  
  5851.  usReserved (USHORT) 
  5852.     Reserved. 
  5853.  
  5854.  
  5855. ΓòÉΓòÉΓòÉ 2.42. LINKITEM ΓòÉΓòÉΓòÉ
  5856.  
  5857. USAGE_LINK structure. 
  5858.  
  5859. typedef struct _LINKITEM {
  5860. WPObject    *LinkObj;  /*  The link object. */
  5861.  } LINKITEM;
  5862.  
  5863. typedef LINKITEM *PLINKITEM;
  5864.  
  5865.  
  5866. ΓòÉΓòÉΓòÉ <hidden> LINKITEM Parameter - LinkObj ΓòÉΓòÉΓòÉ
  5867.  
  5868.  LinkObj (WPObject *) 
  5869.     The link object. 
  5870.  
  5871.     Points to an object of class WPObject. 
  5872.  
  5873.  
  5874. ΓòÉΓòÉΓòÉ 2.43. LONG ΓòÉΓòÉΓòÉ
  5875.  
  5876. Signed integer in the range -2 147 483 648 through 2 147 483 647. 
  5877.  
  5878. #define LONG long
  5879.  
  5880. Note:  Where this data type represents a graphic coordinate in world or model 
  5881.        space, its value is restricted to -134 217 728 through 134 217 727. 
  5882.  
  5883. A graphic coordinate in device or screen coordinates is restricted to -32 768 
  5884. through 32 767. 
  5885.  
  5886. The value of a graphic coordinate may be further restricted by any transforms 
  5887. currently in force, including the positioning of the origin of the window on 
  5888. the screen. In particular, coordinates in world or model space must not 
  5889. generate coordinate values after transformation (that is, in device or screen 
  5890. space) outside the range -32 768 through 32 767. 
  5891.  
  5892.  
  5893. ΓòÉΓòÉΓòÉ 2.44. MEMORYITEM ΓòÉΓòÉΓòÉ
  5894.  
  5895. USAGE_MEMORY structure. 
  5896.  
  5897. typedef struct _MEMORYITEM {
  5898. ULONG   cbBuffer;  /*  Number of bytes in the memory block. */
  5899.  } MEMORYITEM;
  5900.  
  5901. typedef MEMORYITEM *PMEMORYITEM;
  5902.  
  5903.  
  5904. ΓòÉΓòÉΓòÉ <hidden> MEMORYITEM Parameter - cbBuffer ΓòÉΓòÉΓòÉ
  5905.  
  5906.  cbBuffer (ULONG) 
  5907.     Number of bytes in the memory block. 
  5908.  
  5909.  
  5910. ΓòÉΓòÉΓòÉ 2.45. MINIRECORDCORE ΓòÉΓòÉΓòÉ
  5911.  
  5912. Structure that contains information for records smaller than those defined by 
  5913. the RECORDCORE data structure. This data structure is used if the 
  5914. CCS_MINIRECORDCORE style bit is specified when a container is created. 
  5915.  
  5916. typedef struct _MINIRECORDCORE {
  5917. ULONG                      cb;               /*  Structure size. */
  5918. ULONG                      flRecordAttr;     /*  Attributes of container records. */
  5919. POINTL                     ptlIcon;          /*  Record position. */
  5920. struct _MINIRECORDCORE    *preccNextRecord;  /*  Pointer to the next linked record. */
  5921. PSZ                        pszIcon;          /*  Record text. */
  5922. HPOINTER                   hptrIcon;         /*  Record icon. */
  5923.  } MINIRECORDCORE;
  5924.  
  5925. typedef MINIRECORDCORE *PMINIRECORDCORE;
  5926.  
  5927.  
  5928. ΓòÉΓòÉΓòÉ <hidden> MINIRECORDCORE Parameter - cb ΓòÉΓòÉΓòÉ
  5929.  
  5930.  cb (ULONG) 
  5931.     Structure size. 
  5932.  
  5933.     The size (in bytes) of the MINIRECORDCORE structure. 
  5934.  
  5935.  
  5936. ΓòÉΓòÉΓòÉ <hidden> MINIRECORDCORE Parameter - flRecordAttr ΓòÉΓòÉΓòÉ
  5937.  
  5938.  flRecordAttr (ULONG) 
  5939.     Attributes of container records. 
  5940.  
  5941.     Contains any or all of the following: 
  5942.  
  5943.       CRA_COLLAPSED 
  5944.          Specifies that a record is collapsed. 
  5945.  
  5946.       CRA_CURSORED 
  5947.          Specifies that a record will be drawn with a selection cursor. 
  5948.  
  5949.       CRA_DROPONABLE 
  5950.          Specifies that a record can be a target for direct manipulation. 
  5951.  
  5952.       CRA_EXPANDED 
  5953.          Specifies that a record is expanded. 
  5954.  
  5955.       CRA_FILTERED 
  5956.          Specifies that a record is filtered and, therefore, hidden from view. 
  5957.  
  5958.       CRA_INUSE 
  5959.          Specifies that a record will be drawn with in-use emphasis. 
  5960.  
  5961.       CRA_RECORDREADONLY 
  5962.          Prevents a record from being edited directly. 
  5963.  
  5964.       CRA_SELECTED 
  5965.          Specifies that a record will be drawn with selected-state emphasis. 
  5966.  
  5967.       CRA_TARGET 
  5968.          Specifies that a record will be drawn with target emphasis. 
  5969.  
  5970.  
  5971. ΓòÉΓòÉΓòÉ <hidden> MINIRECORDCORE Parameter - ptlIcon ΓòÉΓòÉΓòÉ
  5972.  
  5973.  ptlIcon (POINTL) 
  5974.     Record position. 
  5975.  
  5976.     Position of a container record in the icon view. 
  5977.  
  5978.  
  5979. ΓòÉΓòÉΓòÉ <hidden> MINIRECORDCORE Parameter - preccNextRecord ΓòÉΓòÉΓòÉ
  5980.  
  5981.  preccNextRecord (struct _MINIRECORDCORE *) 
  5982.     Pointer to the next linked record. 
  5983.  
  5984.  
  5985. ΓòÉΓòÉΓòÉ <hidden> MINIRECORDCORE Parameter - pszIcon ΓòÉΓòÉΓòÉ
  5986.  
  5987.  pszIcon (PSZ) 
  5988.     Record text. 
  5989.  
  5990.     Text for the container record. 
  5991.  
  5992.  
  5993. ΓòÉΓòÉΓòÉ <hidden> MINIRECORDCORE Parameter - hptrIcon ΓòÉΓòÉΓòÉ
  5994.  
  5995.  hptrIcon (HPOINTER) 
  5996.     Record icon. 
  5997.  
  5998.     Icon that is displayed for the container record. 
  5999.  
  6000.  
  6001. ΓòÉΓòÉΓòÉ 2.46. MPARAM ΓòÉΓòÉΓòÉ
  6002.  
  6003. A 4-byte message-dependent parameter structure. 
  6004.  
  6005. typedef VOID * MPARAM;
  6006.  
  6007. Certain elements of information, placed into the parameters of a message, have 
  6008. data types that do not use all four bytes of this data type. The rules 
  6009. governing these cases are: 
  6010.  
  6011.  BOOL      The value is contained in the low word and the high word is 0. 
  6012.  SHORT     The value is contained in the low word and its sign is extended into 
  6013.            the high word. 
  6014.  USHORT    The value is contained in the low word and the high word is 0. 
  6015.  NULL      The entire four bytes are 0. 
  6016.  
  6017.  The structure of this data type depends on the message. For details, see the 
  6018.  description of the particular message. 
  6019.  
  6020.  
  6021. ΓòÉΓòÉΓòÉ 2.47. MRESULT ΓòÉΓòÉΓòÉ
  6022.  
  6023. A 4-byte message-dependent reply parameter structure. 
  6024.  
  6025. typedef VOID * MRESULT;
  6026.  
  6027. Certain elements of information, placed into the parameters of a message, have 
  6028. data types that do not use all four bytes of this data type. The rules 
  6029. governing these cases are: 
  6030.  
  6031.  BOOL      The value is contained in the low word and the high word is 0. 
  6032.  SHORT     The value is contained in the low word and its sign is extended into 
  6033.            the high word. 
  6034.  USHORT    The value is contained in the low word and the high word is 0. 
  6035.  NULL      The entire four bytes are 0. 
  6036.  
  6037.  The structure of this data type depends on the message. For details, see the 
  6038.  description of the particular message. 
  6039.  
  6040.  
  6041. ΓòÉΓòÉΓòÉ 2.48. OBJCLASS ΓòÉΓòÉΓòÉ
  6042.  
  6043. Object class structure. 
  6044.  
  6045. typedef struct _OBJCLASS {
  6046. struct _OBJCLASS    *pNext;         /*  Pointer to the next object class structure. */
  6047. PSZ                  pszClassName;  /*  Class name. */
  6048. PSZ                  pszModName;    /*  Module name. */
  6049.  } OBJCLASS;
  6050.  
  6051. typedef OBJCLASS *POBJCLASS;
  6052.  
  6053.  
  6054. ΓòÉΓòÉΓòÉ <hidden> OBJCLASS Parameter - pNext ΓòÉΓòÉΓòÉ
  6055.  
  6056.  pNext (struct _OBJCLASS *) 
  6057.     Pointer to the next object class structure. 
  6058.  
  6059.  
  6060. ΓòÉΓòÉΓòÉ <hidden> OBJCLASS Parameter - pszClassName ΓòÉΓòÉΓòÉ
  6061.  
  6062.  pszClassName (PSZ) 
  6063.     Class name. 
  6064.  
  6065.  
  6066. ΓòÉΓòÉΓòÉ <hidden> OBJCLASS Parameter - pszModName ΓòÉΓòÉΓòÉ
  6067.  
  6068.  pszModName (PSZ) 
  6069.     Module name. 
  6070.  
  6071.  
  6072. ΓòÉΓòÉΓòÉ 2.49. OBJDATA ΓòÉΓòÉΓòÉ
  6073.  
  6074. Object data structure. Class-specific information is contained in this 
  6075. structure. 
  6076.  
  6077. typedef struct _OBJDATA {
  6078. WPSRCLASSBLOCK    *CurrentClass;  /*  Pointer to the current save or restore class block. */
  6079. WPSRCLASSBLOCK    *First;         /*  Pointer to the first save or restore class block. */
  6080. PUCHAR             NextData;      /*  Pointer to the next block of data. */
  6081. USHORT             Length;        /*  Length. */
  6082.  } OBJDATA;
  6083.  
  6084. typedef OBJDATA *POBJDATA;
  6085.  
  6086.  
  6087. ΓòÉΓòÉΓòÉ <hidden> OBJDATA Parameter - CurrentClass ΓòÉΓòÉΓòÉ
  6088.  
  6089.  CurrentClass (WPSRCLASSBLOCK *) 
  6090.     Pointer to the current save or restore class block. 
  6091.  
  6092.  
  6093. ΓòÉΓòÉΓòÉ <hidden> OBJDATA Parameter - First ΓòÉΓòÉΓòÉ
  6094.  
  6095.  First (WPSRCLASSBLOCK *) 
  6096.     Pointer to the first save or restore class block. 
  6097.  
  6098.  
  6099. ΓòÉΓòÉΓòÉ <hidden> OBJDATA Parameter - NextData ΓòÉΓòÉΓòÉ
  6100.  
  6101.  NextData (PUCHAR) 
  6102.     Pointer to the next block of data. 
  6103.  
  6104.  
  6105. ΓòÉΓòÉΓòÉ <hidden> OBJDATA Parameter - Length ΓòÉΓòÉΓòÉ
  6106.  
  6107.  Length (USHORT) 
  6108.     Length. 
  6109.  
  6110.  
  6111. ΓòÉΓòÉΓòÉ 2.50. OBJECT ΓòÉΓòÉΓòÉ
  6112.  
  6113. Pointer to an object of class WPObject. 
  6114.  
  6115. typedef WPObject * OBJECT;
  6116.  
  6117.  
  6118. ΓòÉΓòÉΓòÉ 2.51. OWNERITEM ΓòÉΓòÉΓòÉ
  6119.  
  6120. Owner item. 
  6121.  
  6122. typedef struct _OWNERITEM {
  6123. HWND    hwnd;            /*  Window handle. */
  6124. HPS     hps;             /*  Presentation-space handle. */
  6125. ULONG   fsState;         /*  State. */
  6126. ULONG   fsAttribute;     /*  Attribute. */
  6127. ULONG   fsStateOld;      /*  Old state. */
  6128. ULONG   fsAttributeOld;  /*  Old attribute. */
  6129. RECTL   rclItem;         /*  Item rectangle. */
  6130. LONG    idItem;          /*  Item identity. */
  6131. ULONG   hItem;           /*  Item. */
  6132.  } OWNERITEM;
  6133.  
  6134. typedef OWNERITEM *POWNERITEM;
  6135.  
  6136.  
  6137. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - hwnd ΓòÉΓòÉΓòÉ
  6138.  
  6139.  hwnd (HWND) 
  6140.     Window handle. 
  6141.  
  6142.  
  6143. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - hps ΓòÉΓòÉΓòÉ
  6144.  
  6145.  hps (HPS) 
  6146.     Presentation-space handle. 
  6147.  
  6148.  
  6149. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - fsState ΓòÉΓòÉΓòÉ
  6150.  
  6151.  fsState (ULONG) 
  6152.     State. 
  6153.  
  6154.  
  6155. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - fsAttribute ΓòÉΓòÉΓòÉ
  6156.  
  6157.  fsAttribute (ULONG) 
  6158.     Attribute. 
  6159.  
  6160.  
  6161. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - fsStateOld ΓòÉΓòÉΓòÉ
  6162.  
  6163.  fsStateOld (ULONG) 
  6164.     Old state. 
  6165.  
  6166.  
  6167. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - fsAttributeOld ΓòÉΓòÉΓòÉ
  6168.  
  6169.  fsAttributeOld (ULONG) 
  6170.     Old attribute. 
  6171.  
  6172.  
  6173. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - rclItem ΓòÉΓòÉΓòÉ
  6174.  
  6175.  rclItem (RECTL) 
  6176.     Item rectangle. 
  6177.  
  6178.  
  6179. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - idItem ΓòÉΓòÉΓòÉ
  6180.  
  6181.  idItem (LONG) 
  6182.     Item identity. 
  6183.  
  6184.  
  6185. ΓòÉΓòÉΓòÉ <hidden> OWNERITEM Parameter - hItem ΓòÉΓòÉΓòÉ
  6186.  
  6187.  hItem (ULONG) 
  6188.     Item. 
  6189.  
  6190.  
  6191. ΓòÉΓòÉΓòÉ 2.52. PAGEINFO ΓòÉΓòÉΓòÉ
  6192.  
  6193. Settings page information structure. 
  6194.  
  6195. typedef struct _PAGEINFO {
  6196. ULONG     cb;                  /*  Length of PAGEINFO structure. */
  6197. HWND      hwndPage;            /*  Handle of page. */
  6198. PFNWP     pfnwp;               /*  Window procedure. */
  6199. ULONG     resid;               /*  Resource identity. */
  6200. PVOID     pCreateParams;       /*  Pointer to creation parameters. */
  6201. USHORT    dlgid;               /*  Dialog identity. */
  6202. USHORT    usPageStyleFlags;    /*  Notebook control-page style flags. */
  6203. USHORT    usPageInsertFlags;   /*  Notebook control-page insertion flags. */
  6204. USHORT    usSettingsFlags;     /*  Settings flag. */
  6205. PSZ       pszName;             /*  Pointer to a string containing the page name. */
  6206. USHORT    idDefaultHelpPanel;  /*  Identity of the default help panel. */
  6207. USHORT    usReserved2;         /*  Reserved value; must be zero. */
  6208. PSZ       pszHelpLibraryName;  /*  Pointer to the name of the help file. */
  6209. PUSHORT   pHelpSubtable;       /*  Pointer to the help subtable. */
  6210. HMODULE   hmodHelpSubtable;    /*  Module handle for the help subtable. */
  6211. ULONG     ulPageInsertId;      /*  Notebook control-page identity. */
  6212.  } PAGEINFO;
  6213.  
  6214. typedef PAGEINFO *PPAGEINFO;
  6215.  
  6216.  
  6217. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - cb ΓòÉΓòÉΓòÉ
  6218.  
  6219.  cb (ULONG) 
  6220.     Length of PAGEINFO structure. 
  6221.  
  6222.  
  6223. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - hwndPage ΓòÉΓòÉΓòÉ
  6224.  
  6225.  hwndPage (HWND) 
  6226.     Handle of page. 
  6227.  
  6228.  
  6229. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - pfnwp ΓòÉΓòÉΓòÉ
  6230.  
  6231.  pfnwp (PFNWP) 
  6232.     Window procedure. 
  6233.  
  6234.  
  6235. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - resid ΓòÉΓòÉΓòÉ
  6236.  
  6237.  resid (ULONG) 
  6238.     Resource identity. 
  6239.  
  6240.  
  6241. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - pCreateParams ΓòÉΓòÉΓòÉ
  6242.  
  6243.  pCreateParams (PVOID) 
  6244.     Pointer to creation parameters. 
  6245.  
  6246.  
  6247. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - dlgid ΓòÉΓòÉΓòÉ
  6248.  
  6249.  dlgid (USHORT) 
  6250.     Dialog identity. 
  6251.  
  6252.  
  6253. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - usPageStyleFlags ΓòÉΓòÉΓòÉ
  6254.  
  6255.  usPageStyleFlags (USHORT) 
  6256.     Notebook control-page style flags. 
  6257.  
  6258.  
  6259. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - usPageInsertFlags ΓòÉΓòÉΓòÉ
  6260.  
  6261.  usPageInsertFlags (USHORT) 
  6262.     Notebook control-page insertion flags. 
  6263.  
  6264.  
  6265. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - usSettingsFlags ΓòÉΓòÉΓòÉ
  6266.  
  6267.  usSettingsFlags (USHORT) 
  6268.     Settings flag. 
  6269.  
  6270.     This flag must be set to one of the following values: 
  6271.  
  6272.       0 
  6273.          You will not get page numbers. 
  6274.  
  6275.       SETTINGS_PAGE_NUMBERS 
  6276.          Page numbers will automatically be put on the status line for pages 
  6277.          that have minor pages under the major tab page. 
  6278.  
  6279.          If you want to use the page numbers, make sure all pages have this 
  6280.          setting. 
  6281.  
  6282.  
  6283. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - pszName ΓòÉΓòÉΓòÉ
  6284.  
  6285.  pszName (PSZ) 
  6286.     Pointer to a string containing the page name. 
  6287.  
  6288.  
  6289. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - idDefaultHelpPanel ΓòÉΓòÉΓòÉ
  6290.  
  6291.  idDefaultHelpPanel (USHORT) 
  6292.     Identity of the default help panel. 
  6293.  
  6294.  
  6295. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - usReserved2 ΓòÉΓòÉΓòÉ
  6296.  
  6297.  usReserved2 (USHORT) 
  6298.     Reserved value; must be zero. 
  6299.  
  6300.  
  6301. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - pszHelpLibraryName ΓòÉΓòÉΓòÉ
  6302.  
  6303.  pszHelpLibraryName (PSZ) 
  6304.     Pointer to the name of the help file. 
  6305.  
  6306.  
  6307. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - pHelpSubtable ΓòÉΓòÉΓòÉ
  6308.  
  6309.  pHelpSubtable (PUSHORT) 
  6310.     Pointer to the help subtable. 
  6311.  
  6312.  
  6313. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - hmodHelpSubtable ΓòÉΓòÉΓòÉ
  6314.  
  6315.  hmodHelpSubtable (HMODULE) 
  6316.     Module handle for the help subtable. 
  6317.  
  6318.  
  6319. ΓòÉΓòÉΓòÉ <hidden> PAGEINFO Parameter - ulPageInsertId ΓòÉΓòÉΓòÉ
  6320.  
  6321.  ulPageInsertId (ULONG) 
  6322.     Notebook control-page identity. 
  6323.  
  6324.  
  6325. ΓòÉΓòÉΓòÉ 2.53. PALINFO ΓòÉΓòÉΓòÉ
  6326.  
  6327. Class-specific palette information data. 
  6328.  
  6329. typedef struct _PALINFO {
  6330. ULONG   xCellCount;   /*  Number of columns of palinfos. */
  6331. ULONG   yCellCount;   /*  Number of rows of palinfos. */
  6332. ULONG   xCursor;      /*  Cursor location (read only). */
  6333. ULONG   yCursor;      /*  Cursor location (read only). */
  6334. ULONG   xCellWidth;   /*  Width of each palinfo. */
  6335. ULONG   yCellHeight;  /*  Height of each palinfo. */
  6336. ULONG   xGap;         /*  X separation of palinfos. */
  6337. ULONG   yGap;         /*  Y separation of palinfos. */
  6338.  } PALINFO;
  6339.  
  6340. typedef PALINFO *PPALINFO;
  6341.  
  6342.  
  6343. ΓòÉΓòÉΓòÉ <hidden> PALINFO Parameter - xCellCount ΓòÉΓòÉΓòÉ
  6344.  
  6345.  xCellCount (ULONG) 
  6346.     Number of columns of palinfos. 
  6347.  
  6348.  
  6349. ΓòÉΓòÉΓòÉ <hidden> PALINFO Parameter - yCellCount ΓòÉΓòÉΓòÉ
  6350.  
  6351.  yCellCount (ULONG) 
  6352.     Number of rows of palinfos. 
  6353.  
  6354.  
  6355. ΓòÉΓòÉΓòÉ <hidden> PALINFO Parameter - xCursor ΓòÉΓòÉΓòÉ
  6356.  
  6357.  xCursor (ULONG) 
  6358.     Cursor location (read only). 
  6359.  
  6360.  
  6361. ΓòÉΓòÉΓòÉ <hidden> PALINFO Parameter - yCursor ΓòÉΓòÉΓòÉ
  6362.  
  6363.  yCursor (ULONG) 
  6364.     Cursor location (read only). 
  6365.  
  6366.  
  6367. ΓòÉΓòÉΓòÉ <hidden> PALINFO Parameter - xCellWidth ΓòÉΓòÉΓòÉ
  6368.  
  6369.  xCellWidth (ULONG) 
  6370.     Width of each palinfo. 
  6371.  
  6372.  
  6373. ΓòÉΓòÉΓòÉ <hidden> PALINFO Parameter - yCellHeight ΓòÉΓòÉΓòÉ
  6374.  
  6375.  yCellHeight (ULONG) 
  6376.     Height of each palinfo. 
  6377.  
  6378.  
  6379. ΓòÉΓòÉΓòÉ <hidden> PALINFO Parameter - xGap ΓòÉΓòÉΓòÉ
  6380.  
  6381.  xGap (ULONG) 
  6382.     X separation of palinfos. 
  6383.  
  6384.  
  6385. ΓòÉΓòÉΓòÉ <hidden> PALINFO Parameter - yGap ΓòÉΓòÉΓòÉ
  6386.  
  6387.  yGap (ULONG) 
  6388.     Y separation of palinfos. 
  6389.  
  6390.  
  6391. ΓòÉΓòÉΓòÉ 2.54. PCSZ ΓòÉΓòÉΓòÉ
  6392.  
  6393. Pointer to a constant null-terminated string. 
  6394.  
  6395. typedef const char * PCSZ;
  6396.  
  6397.  
  6398. ΓòÉΓòÉΓòÉ 2.55. PDEVOPENDATA ΓòÉΓòÉΓòÉ
  6399.  
  6400. Open device-data array. 
  6401.  
  6402. This data type points to data whose format is described by the DEVOPENSTRUC 
  6403. data type. 
  6404.  
  6405. typedef PSZ * PDEVOPENDATA;
  6406.  
  6407.  
  6408. ΓòÉΓòÉΓòÉ 2.56. PFNCOMPARE ΓòÉΓòÉΓòÉ
  6409.  
  6410. Pointer to a Details View comparison function. 
  6411.  
  6412. This function would be used if you wanted to sort on a non-standard data type 
  6413. or if you wanted to a custom sort. 
  6414.  
  6415. typedef FNCOMPARE *PFNCOMPARE;
  6416.  
  6417. In the header file, this is a two-part definition as shown below: 
  6418.  
  6419. typedef LONG (EXPENTRY FNCOMPARE)(PVOID, PVOID);
  6420. typedef FNCOMPARE *PFNCOMPARE;
  6421.  
  6422. The first argument (PVOID) is a pointer to the Details View field value. The 
  6423. second argument (PVOID) is a pointer to the value it is to be compared with. 
  6424. The function returns a LONG value that must be one of the following: 
  6425.  
  6426.  CMP_EQUAL             0 
  6427.  CMP_GREATER           1 
  6428.  CMP_LESS              2 
  6429.  
  6430.  
  6431. ΓòÉΓòÉΓòÉ 2.57. PFNOWNDRW ΓòÉΓòÉΓòÉ
  6432.  
  6433. Pointer to an owner-draw function for a Details View field. 
  6434.  
  6435. This function would be used if you wanted to draw the contents of the Details 
  6436. View field yourself, for example, as a graphic image or to use custom 
  6437. formatting. 
  6438.  
  6439. This function is called each time the field is painted. 
  6440.  
  6441. typedef FNOWNDRW *PFNOWNDRW;
  6442.  
  6443. The first argument (HWND) is the handle of the Details View field-window being 
  6444. painted. The second argument (PVOID) is a pointer to an OWNERITEM data 
  6445. structure. The third argument (PVOID) is a pointer to the Comparison value to 
  6446. draw (this argument is NULL except when this function is painting its value 
  6447. into the Include Criteria Dialog (in the Settings notebook), in which case it 
  6448. points to a string containing a comparision value. The function returns a BOOL 
  6449. value of TRUE if the field was owner-drawn or FALSE if the container control 
  6450. should do default painting. 
  6451.  
  6452. In the header file, this is a two-part definition as shown below: 
  6453.  
  6454. typedef BOOL (EXPENTRY FNOWNDRW)(HWND, PVOID, PVOID);
  6455. typedef FNOWNDRW *PFNOWNDRW;
  6456.  
  6457.  
  6458. ΓòÉΓòÉΓòÉ 2.58. PFNWP ΓòÉΓòÉΓòÉ
  6459.  
  6460. Pointer to a window procedure. 
  6461.  
  6462. This is the standard function definition for window procedures. 
  6463.  
  6464. typedef FNWP *PFNWP;
  6465.  
  6466. The first argument (HWND) is the handle of the window receiving the message. 
  6467. The second argument (ULONG) is a message identifier. The third argument 
  6468. (MPARAM) is the first message paramenter (mp1). The fourth argument (MPARAM) is 
  6469. the second message paramenter (mp2). The function returns an MRESULT. Each 
  6470. message has a specific set of possible return codes. The window procedure must 
  6471. return a value that is appropriate for the message being processed. 
  6472.  
  6473. In the header file, this is a two-part definition as shown below: 
  6474.  
  6475. typedef MRESULT (EXPENTRY FNWP)(HWND, ULONG, MPARAM, MPARAM);
  6476. typedef FNWP *PFNWP;
  6477.  
  6478. Window procedures must be EXPORTED in the definitions file used by the linker. 
  6479.  
  6480.  
  6481. ΓòÉΓòÉΓòÉ 2.59. POINTL ΓòÉΓòÉΓòÉ
  6482.  
  6483. Point structure (long integers). 
  6484.  
  6485. typedef struct _POINTL {
  6486. LONG   x;  /*  X-coordinate. */
  6487. LONG   y;  /*  Y-coordinate. */
  6488.  } POINTL;
  6489.  
  6490. typedef POINTL *PPOINTL;
  6491.  
  6492.  
  6493. ΓòÉΓòÉΓòÉ <hidden> POINTL Parameter - x ΓòÉΓòÉΓòÉ
  6494.  
  6495.  x (LONG) 
  6496.     X-coordinate. 
  6497.  
  6498.  
  6499. ΓòÉΓòÉΓòÉ <hidden> POINTL Parameter - y ΓòÉΓòÉΓòÉ
  6500.  
  6501.  y (LONG) 
  6502.     Y-coordinate. 
  6503.  
  6504.  
  6505. ΓòÉΓòÉΓòÉ 2.60. PRINTDEST ΓòÉΓòÉΓòÉ
  6506.  
  6507. PRINTDEST data structure. 
  6508.  
  6509. Contains all the parameters required to issue DevPostDeviceModes and DevOpenDC 
  6510. function calls. 
  6511.  
  6512. typedef struct _PRINTDEST {
  6513. ULONG          cb;          /*  Length of data structure, in bytes. */
  6514. LONG           lType;       /*  Type of device context. */
  6515. PSZ            pszToken;    /*  Device-information token. */
  6516. LONG           lCount;      /*  Number of items. */
  6517. PDEVOPENDATA   pdopData;    /*  Open device context data area. */
  6518. ULONG          fl;          /*  Flags. */
  6519. PSZ            pszPrinter;  /*  Name of the printer. */
  6520.  } PRINTDEST;
  6521.  
  6522. typedef PRINTDEST *PPRINTDEST;
  6523.  
  6524.  
  6525. ΓòÉΓòÉΓòÉ <hidden> PRINTDEST Parameter - cb ΓòÉΓòÉΓòÉ
  6526.  
  6527.  cb (ULONG) 
  6528.     Length of data structure, in bytes. 
  6529.  
  6530.  
  6531. ΓòÉΓòÉΓòÉ <hidden> PRINTDEST Parameter - lType ΓòÉΓòÉΓòÉ
  6532.  
  6533.  lType (LONG) 
  6534.     Type of device context. 
  6535.  
  6536.       OD_QUEUED 
  6537.          The device context is queued. 
  6538.       OD_DIRECT 
  6539.          The device context is direct. 
  6540.  
  6541.  
  6542. ΓòÉΓòÉΓòÉ <hidden> PRINTDEST Parameter - pszToken ΓòÉΓòÉΓòÉ
  6543.  
  6544.  pszToken (PSZ) 
  6545.     Device-information token. 
  6546.  
  6547.     This is always "*". 
  6548.  
  6549.  
  6550. ΓòÉΓòÉΓòÉ <hidden> PRINTDEST Parameter - lCount ΓòÉΓòÉΓòÉ
  6551.  
  6552.  lCount (LONG) 
  6553.     Number of items. 
  6554.  
  6555.     This is the number of items present in the pdopData field. 
  6556.  
  6557.  
  6558. ΓòÉΓòÉΓòÉ <hidden> PRINTDEST Parameter - pdopData ΓòÉΓòÉΓòÉ
  6559.  
  6560.  pdopData (PDEVOPENDATA) 
  6561.     Open device context data area. 
  6562.  
  6563.     See DEVOPENSTRUC for information on the format of pdopData. 
  6564.  
  6565.  
  6566. ΓòÉΓòÉΓòÉ <hidden> PRINTDEST Parameter - fl ΓòÉΓòÉΓòÉ
  6567.  
  6568.  fl (ULONG) 
  6569.     Flags. 
  6570.  
  6571.       PD_JOB_PROPERTY 
  6572.          This flag indicates that DevPostDeviceModes should be called with 
  6573.          DPDM_POSTJOBPROP before calling DevOpenDC. 
  6574.  
  6575.  
  6576. ΓòÉΓòÉΓòÉ <hidden> PRINTDEST Parameter - pszPrinter ΓòÉΓòÉΓòÉ
  6577.  
  6578.  pszPrinter (PSZ) 
  6579.     Name of the printer. 
  6580.  
  6581.     A name that specifies the device; for example, "PRINTER1". The name is used 
  6582.     for calling DevPostDeviceModes. 
  6583.  
  6584.     The printer device name can be found by calling SplQueryQueue and passing 
  6585.     to it the information found in the pszLogAddress field of the DEVOPENSTRUC 
  6586.     structure pointed to by pdopData. SplQueryQueue returns a PRQINFO3 
  6587.     structure. The pszPrinters field in PRQINFO3 contains the printer device 
  6588.     name to be used. 
  6589.  
  6590.  
  6591. ΓòÉΓòÉΓòÉ 2.61. PROGCATEGORY ΓòÉΓòÉΓòÉ
  6592.  
  6593. Program category. 
  6594.  
  6595. typedef ULONG PROGCATEGORY;
  6596.  
  6597.  
  6598. ΓòÉΓòÉΓòÉ 2.62. PROGDETAILS ΓòÉΓòÉΓòÉ
  6599.  
  6600. Program-details structure. 
  6601.  
  6602. typedef struct _PROGDETAILS {
  6603. ULONG      Length;          /*  Length of structure. */
  6604. PROGTYPE   progt;           /*  Program type. */
  6605. PSZ        pszTitle;        /*  Title. */
  6606. PSZ        pszExecutable;   /*  Executable file name. */
  6607. PSZ        pszParameters;   /*  Parameter string. */
  6608. PSZ        pszStartupDir;   /*  Start-up directory. */
  6609. PSZ        pszIcon;         /*  Icon-file name. */
  6610. PSZ        pszEnvironment;  /*  Environment string. */
  6611. SWP        swpInitial;      /*  Initial window position and size. */
  6612.  } PROGDETAILS;
  6613.  
  6614. typedef PROGDETAILS *PPROGDETAILS;
  6615.  
  6616.  
  6617. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - Length ΓòÉΓòÉΓòÉ
  6618.  
  6619.  Length (ULONG) 
  6620.     Length of structure. 
  6621.  
  6622.  
  6623. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - progt ΓòÉΓòÉΓòÉ
  6624.  
  6625.  progt (PROGTYPE) 
  6626.     Program type. 
  6627.  
  6628.  
  6629. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - pszTitle ΓòÉΓòÉΓòÉ
  6630.  
  6631.  pszTitle (PSZ) 
  6632.     Title. 
  6633.  
  6634.  
  6635. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - pszExecutable ΓòÉΓòÉΓòÉ
  6636.  
  6637.  pszExecutable (PSZ) 
  6638.     Executable file name. 
  6639.  
  6640.  
  6641. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - pszParameters ΓòÉΓòÉΓòÉ
  6642.  
  6643.  pszParameters (PSZ) 
  6644.     Parameter string. 
  6645.  
  6646.  
  6647. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - pszStartupDir ΓòÉΓòÉΓòÉ
  6648.  
  6649.  pszStartupDir (PSZ) 
  6650.     Start-up directory. 
  6651.  
  6652.  
  6653. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - pszIcon ΓòÉΓòÉΓòÉ
  6654.  
  6655.  pszIcon (PSZ) 
  6656.     Icon-file name. 
  6657.  
  6658.  
  6659. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - pszEnvironment ΓòÉΓòÉΓòÉ
  6660.  
  6661.  pszEnvironment (PSZ) 
  6662.     Environment string. 
  6663.  
  6664.     A list of null-terminated strings ending with an extra NULL character. 
  6665.  
  6666.  
  6667. ΓòÉΓòÉΓòÉ <hidden> PROGDETAILS Parameter - swpInitial ΓòÉΓòÉΓòÉ
  6668.  
  6669.  swpInitial (SWP) 
  6670.     Initial window position and size. 
  6671.  
  6672.  
  6673. ΓòÉΓòÉΓòÉ 2.63. PROGTYPE ΓòÉΓòÉΓòÉ
  6674.  
  6675. Program-type structure. 
  6676.  
  6677. typedef struct _PROGTYPE {
  6678. PROGCATEGORY   progc;      /*  Program category: */
  6679. ULONG          fbVisible;  /*  Visibility attribute. */
  6680.  } PROGTYPE;
  6681.  
  6682. typedef PROGTYPE *PPROGTYPE;
  6683.  
  6684.  
  6685. ΓòÉΓòÉΓòÉ <hidden> PROGTYPE Parameter - progc ΓòÉΓòÉΓòÉ
  6686.  
  6687.  progc (PROGCATEGORY) 
  6688.     Program category: 
  6689.  
  6690.       PROG_DEFAULT 
  6691.          Default application. 
  6692.       PROG_PM 
  6693.          Presentation Manager application. 
  6694.       PROG_WINDOWABLEVIO 
  6695.          Text-windowed application. 
  6696.       PROG_FULLSCREEN 
  6697.          Full-screen application. 
  6698.       PROG_WINDOWEDVDM 
  6699.          PC DOS executable process (windowed). 
  6700.       PROG_VDM 
  6701.          PC DOS executable process (full screen). 
  6702.       PROG_REAL 
  6703.          PC DOS executable process (full screen). Same as PROG_VDM. 
  6704.       PROG_31_STDSEAMLESSVDM 
  6705.          Windows 3.1 program that will execute in its own windowed WINOS2 
  6706.          session. 
  6707.       PROG_31_STDSEAMLESSCOMMON 
  6708.          Windows 3.1 program that will execute in a common windowed WINOS2 
  6709.          session. 
  6710.       PROG_31_ENHSEAMLESSVDM 
  6711.          Windows 3.1 program that will execute in enhanced compatibility mode 
  6712.          in its own windowed WINOS2 session. 
  6713.       PROG_31_ENHSEAMLESSCOMMON 
  6714.          Windows 3.1 program that will execute in enhanced compatibility mode 
  6715.          in a common windowed WINOS2 session. 
  6716.       PROG_31_ENH 
  6717.          Windows 3.1 program that will execute in enhanced compatibility mode 
  6718.          in a full-screen WINOS2 session. 
  6719.       PROG_31_STD 
  6720.          Windows 3.1 program that will execute in a full-screen WINOS2 session. 
  6721.  
  6722.  
  6723. ΓòÉΓòÉΓòÉ <hidden> PROGTYPE Parameter - fbVisible ΓòÉΓòÉΓòÉ
  6724.  
  6725.  fbVisible (ULONG) 
  6726.     Visibility attribute. 
  6727.  
  6728.     When testing this field, allow for the possibility that other bits may be 
  6729.     defined in the future. SHE_INVISIBLE and SHE_PROTECTED can be used to mask 
  6730.     the visibility and protected flags, respectively. 
  6731.  
  6732.       SHE_VISIBLE 
  6733.          Visible 
  6734.       SHE_INVISIBLE 
  6735.          Invisible 
  6736.       SHE_UNPROTECTED 
  6737.          Unprotected 
  6738.       SHE_PROTECTED 
  6739.          Protected. 
  6740.  
  6741.  
  6742. ΓòÉΓòÉΓòÉ 2.64. PRQINFO3 ΓòÉΓòÉΓòÉ
  6743.  
  6744. Print-queue information structure. 
  6745.  
  6746. This structure is used at information levels 3 and 4. 
  6747.  
  6748. typedef struct _PRQINFO3 {
  6749. PSZ         pszName;        /*  Queue name. */
  6750. USHORT      uPriority;      /*  Queue priority. */
  6751. USHORT      uStartTime;     /*  Minutes after midnight when queue becomes active. */
  6752. USHORT      uUntilTime;     /*  Minutes after midnight. when queue ceases to be active. */
  6753. USHORT      fsType;         /*  Queue type. */
  6754. PSZ         pszSepFile;     /*  Separator-page file. */
  6755. PSZ         pszPrProc;      /*  Default queue-processor. */
  6756. PSZ         pszParms;       /*  Queue parameters. */
  6757. PSZ         pszComment;     /*  Queue description. */
  6758. USHORT      fsStatus;       /*  Queue status. */
  6759. USHORT      cJobs;          /*  Number of jobs in queue. */
  6760. PSZ         pszPrinters;    /*  Print devices connected to queue. */
  6761. PSZ         pszDriverName;  /*  Default device driver. */
  6762. PDRIVDATA   pDriverData;    /*  Default queue job properties. */
  6763.  } PRQINFO3;
  6764.  
  6765. typedef PRQINFO3 *PPRQINFO3;
  6766.  
  6767.  
  6768. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - pszName ΓòÉΓòÉΓòÉ
  6769.  
  6770.  pszName (PSZ) 
  6771.     Queue name. 
  6772.  
  6773.     The maximum length of the name in the network case is 256 (including one 
  6774.     byte for zero termination). 
  6775.  
  6776.  
  6777. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - uPriority ΓòÉΓòÉΓòÉ
  6778.  
  6779.  uPriority (USHORT) 
  6780.     Queue priority. 
  6781.  
  6782.     The range is 1 through 9, with 1 being the highest queue priority. 
  6783.  
  6784.     The default job priority (DefJobPrio) is determined from: 
  6785.     DefJobPrio=100-(10* uPriority). 
  6786.  
  6787.     If a job is added with  PRJ_NO_PRIORITY  specified, DefJobPrio is used. If 
  6788.     a default priority higher than the default job priority is specified, the 
  6789.     default job priority is used. If a default priority lower than the default 
  6790.     is specified, the specified job priority is used. 
  6791.  
  6792.       PRQ_DEF_PRIORITY 
  6793.          Default priority 
  6794.       PRQ_MAX_PRIORITY 
  6795.          Highest priority 
  6796.       PRQ_MIN_PRIORITY 
  6797.          Minimum priority 
  6798.       PRQ_NO_PRIORITY 
  6799.          No priority. 
  6800.  
  6801.  
  6802. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - uStartTime ΓòÉΓòÉΓòÉ
  6803.  
  6804.  uStartTime (USHORT) 
  6805.     Minutes after midnight when queue becomes active. 
  6806.  
  6807.     For example, the value 75 represents 1:15 a.m. 
  6808.  
  6809.     If uStartTime and uUntilTime are both 0, the print queue is always 
  6810.     available. 
  6811.  
  6812.  
  6813. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - uUntilTime ΓòÉΓòÉΓòÉ
  6814.  
  6815.  uUntilTime (USHORT) 
  6816.     Minutes after midnight. when queue ceases to be active. 
  6817.  
  6818.     For example, the value 1200 represents 8 p.m. 
  6819.  
  6820.     If uUntilTime and uStartTime are both 0, the print queue is always 
  6821.     available. 
  6822.  
  6823.  
  6824. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - fsType ΓòÉΓòÉΓòÉ
  6825.  
  6826.  fsType (USHORT) 
  6827.     Queue type. 
  6828.  
  6829.       PRQ3_TYPE_RAW 
  6830.          Data is always enqueued in the device specific format. 
  6831.       PRQ3_TYPE_BYPASS 
  6832.          Allows the spooler to bypass the queue processor and send data 
  6833.          directly to the Printer Driver. Setting this bit allows the spooler to 
  6834.          print jobs of type PM_Q_RAW while they are still being spooled. 
  6835.       PRQ3_TYPE_APPDEFAULT 
  6836.          This bit is set for the application default queue only. 
  6837.  
  6838.  
  6839. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - pszSepFile ΓòÉΓòÉΓòÉ
  6840.  
  6841.  pszSepFile (PSZ) 
  6842.     Separator-page file. 
  6843.  
  6844.     The path and file name of a separator-page file on the target computer. 
  6845.  
  6846.     This file contains formatting information for the page or pages to be used 
  6847.     between print jobs. A relative path name is taken as relative to the 
  6848.     current spool directory. A NULL string indicates no separator page. 
  6849.  
  6850.  
  6851. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - pszPrProc ΓòÉΓòÉΓòÉ
  6852.  
  6853.  pszPrProc (PSZ) 
  6854.     Default queue-processor. 
  6855.  
  6856.  
  6857. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - pszParms ΓòÉΓòÉΓòÉ
  6858.  
  6859.  pszParms (PSZ) 
  6860.     Queue parameters. 
  6861.  
  6862.     This can be any text string or a NULL string. 
  6863.  
  6864.  
  6865. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - pszComment ΓòÉΓòÉΓòÉ
  6866.  
  6867.  pszComment (PSZ) 
  6868.     Queue description. 
  6869.  
  6870.     A NULL string results in no comment. The maximum length is 48 characters 
  6871.     (including one byte for the null terminator). 
  6872.  
  6873.  
  6874. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - fsStatus ΓòÉΓòÉΓòÉ
  6875.  
  6876.  fsStatus (USHORT) 
  6877.     Queue status. 
  6878.  
  6879.       PRQ3_PAUSED 
  6880.          Queue is paused (held). 
  6881.       PRQ3_PENDING 
  6882.          Queue is pending deletion. 
  6883.  
  6884.  
  6885. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - cJobs ΓòÉΓòÉΓòÉ
  6886.  
  6887.  cJobs (USHORT) 
  6888.     Number of jobs in queue. 
  6889.  
  6890.  
  6891. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - pszPrinters ΓòÉΓòÉΓòÉ
  6892.  
  6893.  pszPrinters (PSZ) 
  6894.     Print devices connected to queue. 
  6895.  
  6896.     This cannot be NULL. 
  6897.  
  6898.  
  6899. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - pszDriverName ΓòÉΓòÉΓòÉ
  6900.  
  6901.  pszDriverName (PSZ) 
  6902.     Default device driver. 
  6903.  
  6904.  
  6905. ΓòÉΓòÉΓòÉ <hidden> PRQINFO3 Parameter - pDriverData ΓòÉΓòÉΓòÉ
  6906.  
  6907.  pDriverData (PDRIVDATA) 
  6908.     Default queue job properties. 
  6909.  
  6910.     Note:  An application can use pszDriverName, pDriverData, pszPrProc, and 
  6911.            pszParms to construct a valid DevOpenDC call based only on the queue 
  6912.            name. 
  6913.  
  6914.  
  6915. ΓòÉΓòÉΓòÉ 2.65. PSZ ΓòÉΓòÉΓòÉ
  6916.  
  6917. Pointer to a null-terminated string. 
  6918.  
  6919. If you are using C++ **, you may need to use PCSZ. 
  6920.  
  6921. typedef unsigned char * PSZ;
  6922.  
  6923.  
  6924. ΓòÉΓòÉΓòÉ 2.66. PVOID ΓòÉΓòÉΓòÉ
  6925.  
  6926. Pointer to a data type of undefined format. 
  6927.  
  6928. typedef VOID * PVOID;
  6929.  
  6930.  
  6931. ΓòÉΓòÉΓòÉ 2.67. RECORDCORE ΓòÉΓòÉΓòÉ
  6932.  
  6933. Structure that contains information for records in a container control. This 
  6934. data structure is used if the CCS_MINIRECORDCORE style bit is not specified 
  6935. when a container is created. 
  6936.  
  6937. typedef struct _RECORDCORE {
  6938. ULONG                  cb;               /*  The size, in bytes, of the RECORDCORE structure. */
  6939. ULONG                  flRecordAttr;     /*  Container record attributes. */
  6940. POINTL                 ptlIcon;          /*  Position of a container record in the icon view. */
  6941. struct _RECORDCORE    *preccNextRecord;  /*  Pointer to the next linked record. */
  6942. PSZ                    pszIcon;          /*  Text for the icon view (CV_ICON). */
  6943. HPOINTER               hptrIcon;         /*  Icon that is displayed when the CV_MINI style bit is not specified. */
  6944. HPOINTER               hptrMiniIcon;     /*  Icon that is displayed when the CV_MINI style bit is specified. */
  6945. HBITMAP                hbmBitmap;        /*  Bit map displayed when the CV_MINI style bit is not specified. */
  6946. HBITMAP                hbmMiniBitmap;    /*  Bit map displayed when the CV_MINI style bit is specified. */
  6947. PTREEITEMDESC          pTreeItemDesc;    /*  Pointer to a TREEITEMDESC structure. */
  6948. PSZ                    pszText;          /*  Text for the text view (CV_TEXT). */
  6949. PSZ                    pszName;          /*  Text for the name view (CV_NAME). */
  6950. PSZ                    pszTree;          /*  Text for the tree view (CV_TREE). */
  6951.  } RECORDCORE;
  6952.  
  6953. typedef RECORDCORE *PRECORDCORE;
  6954.  
  6955.  
  6956. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - cb ΓòÉΓòÉΓòÉ
  6957.  
  6958.  cb (ULONG) 
  6959.     The size, in bytes, of the RECORDCORE structure. 
  6960.  
  6961.  
  6962. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - flRecordAttr ΓòÉΓòÉΓòÉ
  6963.  
  6964.  flRecordAttr (ULONG) 
  6965.     Container record attributes. 
  6966.  
  6967.     This parameter can contain any or all of the following: 
  6968.  
  6969.       CRA_COLLAPSED 
  6970.          Specifies that a record is collapsed. 
  6971.  
  6972.       CRA_CURSORED 
  6973.          Specifies that a record will be drawn with a selection cursor. 
  6974.  
  6975.       CRA_DISABLED 
  6976.          Specifies that a record will be drawn with unavailable-state emphasis. 
  6977.  
  6978.       CRA_DROPONABLE 
  6979.          Specifies that a record can be a target for direct manipulation. 
  6980.  
  6981.       CRA_EXPANDED 
  6982.          Specifies that a record is expanded. 
  6983.  
  6984.       CRA_FILTERED 
  6985.          Specifies that a record is filtered and, therefore, hidden from view. 
  6986.  
  6987.       CRA_INUSE 
  6988.          Specifies that a record will be drawn with in-use emphasis. 
  6989.  
  6990.       CRA_PICKED 
  6991.          Specifies that the container record willl be picked up as part of the 
  6992.          drag set. 
  6993.  
  6994.       CRA_SELECTED 
  6995.          Specifies that a record will be drawn with selected-state emphasis. 
  6996.  
  6997.       CRA_SOURCE 
  6998.          Specifies that a record will be drawn with source-menu emphasis. 
  6999.  
  7000.  
  7001. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - ptlIcon ΓòÉΓòÉΓòÉ
  7002.  
  7003.  ptlIcon (POINTL) 
  7004.     Position of a container record in the icon view. 
  7005.  
  7006.  
  7007. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - preccNextRecord ΓòÉΓòÉΓòÉ
  7008.  
  7009.  preccNextRecord (struct _RECORDCORE *) 
  7010.     Pointer to the next linked record. 
  7011.  
  7012.  
  7013. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - pszIcon ΓòÉΓòÉΓòÉ
  7014.  
  7015.  pszIcon (PSZ) 
  7016.     Text for the icon view (CV_ICON). 
  7017.  
  7018.  
  7019. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - hptrIcon ΓòÉΓòÉΓòÉ
  7020.  
  7021.  hptrIcon (HPOINTER) 
  7022.     Icon that is displayed when the CV_MINI style bit is not specified. 
  7023.  
  7024.     This field is used when the CA_DRAWICON container attribute of the CNRINFO 
  7025.     data structure is set. 
  7026.  
  7027.  
  7028. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - hptrMiniIcon ΓòÉΓòÉΓòÉ
  7029.  
  7030.  hptrMiniIcon (HPOINTER) 
  7031.     Icon that is displayed when the CV_MINI style bit is specified. 
  7032.  
  7033.     This field is used when the CA_DRAWICON container attribute of the CNRINFO 
  7034.     data structure is set. 
  7035.  
  7036.  
  7037. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - hbmBitmap ΓòÉΓòÉΓòÉ
  7038.  
  7039.  hbmBitmap (HBITMAP) 
  7040.     Bit map displayed when the CV_MINI style bit is not specified. 
  7041.  
  7042.     This field is used when the CA_DRAWBITMAP container attribute of the 
  7043.     CNRINFO data structure is set. 
  7044.  
  7045.  
  7046. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - hbmMiniBitmap ΓòÉΓòÉΓòÉ
  7047.  
  7048.  hbmMiniBitmap (HBITMAP) 
  7049.     Bit map displayed when the CV_MINI style bit is specified. 
  7050.  
  7051.     This field is used when the CA_DRAWBITMAP container attribute of the 
  7052.     CNRINFO data structure is set. 
  7053.  
  7054.  
  7055. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - pTreeItemDesc ΓòÉΓòÉΓòÉ
  7056.  
  7057.  pTreeItemDesc (PTREEITEMDESC) 
  7058.     Pointer to a TREEITEMDESC structure. 
  7059.  
  7060.     The TREEITEMDESC structure contains the icons and bit maps used to 
  7061.     represent the state of an expanded or collapsed parent item in the tree 
  7062.     name view. 
  7063.  
  7064.  
  7065. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - pszText ΓòÉΓòÉΓòÉ
  7066.  
  7067.  pszText (PSZ) 
  7068.     Text for the text view (CV_TEXT). 
  7069.  
  7070.  
  7071. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - pszName ΓòÉΓòÉΓòÉ
  7072.  
  7073.  pszName (PSZ) 
  7074.     Text for the name view (CV_NAME). 
  7075.  
  7076.  
  7077. ΓòÉΓòÉΓòÉ <hidden> RECORDCORE Parameter - pszTree ΓòÉΓòÉΓòÉ
  7078.  
  7079.  pszTree (PSZ) 
  7080.     Text for the tree view (CV_TREE). 
  7081.  
  7082.  
  7083. ΓòÉΓòÉΓòÉ 2.68. RECORDINSERT ΓòÉΓòÉΓòÉ
  7084.  
  7085. Structure that contains information about RECORDCORE structures that are being 
  7086. inserted into a container. The RECORDINSERT structure is used in the 
  7087. CM_INSERTRECORD container message only. 
  7088.  
  7089. Note:  If the CCS_MINIRECORDCORE style bit is specified when a container is 
  7090.        created, then MINIRECORDCORE should be used instead of RECORDCORE and 
  7091.        PMINIRECORDCORE should be used instead of PRECORDCORE in all applicable 
  7092.        data structures and messages. 
  7093.  
  7094.   typedef struct _RECORDINSERT {
  7095.   ULONG         cb;                 /*  Structure size. */
  7096.   PRECORDCORE   pRecordOrder;       /*  Record order. */
  7097.   PRECORDCORE   pRecordParent;      /*  Pointer to record parent. */
  7098.   ULONG         fInvalidateRecord;  /*  Update flag. */
  7099.   ULONG         zOrder;             /*  Record z-order. */
  7100.   ULONG         cRecordsInsert;     /*  Number of root-level structures. */
  7101.    } RECORDINSERT;
  7102.  
  7103.   typedef RECORDINSERT *PRECORDINSERT;
  7104.  
  7105.  
  7106. ΓòÉΓòÉΓòÉ <hidden> RECORDINSERT Parameter - cb ΓòÉΓòÉΓòÉ
  7107.  
  7108.  cb (ULONG) 
  7109.     Structure size. 
  7110.  
  7111.     The size (in bytes) of the RECORDINSERT structure. 
  7112.  
  7113.  
  7114. ΓòÉΓòÉΓòÉ <hidden> RECORDINSERT Parameter - pRecordOrder ΓòÉΓòÉΓòÉ
  7115.  
  7116.  pRecordOrder (PRECORDCORE) 
  7117.     Record order. 
  7118.  
  7119.     Orders the RECORDCORE structures relative to other RECORDCORE structures in 
  7120.     the container. The values can be: 
  7121.  
  7122.       CMA_FIRST 
  7123.          Places a RECORDCORE structure, or list of RECORDCORE structures, at 
  7124.          the beginning of the list of structures. 
  7125.  
  7126.       CMA_END 
  7127.          Places a RECORDCORE structure, or list of RECORDCORE structures, at 
  7128.          the end of the list of structures. 
  7129.  
  7130.       Other 
  7131.          Pointer to a RECORDCORE structure after which this structure, or list 
  7132.          of structures, is to be inserted. 
  7133.  
  7134.  
  7135. ΓòÉΓòÉΓòÉ <hidden> RECORDINSERT Parameter - pRecordParent ΓòÉΓòÉΓòÉ
  7136.  
  7137.  pRecordParent (PRECORDCORE) 
  7138.     Pointer to record parent. 
  7139.  
  7140.     Pointer to a RECORDCORE structure that is the parent of the records to be 
  7141.     inserted. This field is used only with the CMA_FIRST or CMA_END attributes 
  7142.     of the pRecordOrder field. 
  7143.  
  7144.  
  7145. ΓòÉΓòÉΓòÉ <hidden> RECORDINSERT Parameter - fInvalidateRecord ΓòÉΓòÉΓòÉ
  7146.  
  7147.  fInvalidateRecord (ULONG) 
  7148.     Update flag. 
  7149.  
  7150.     Flag that indicates an automatic display update after RECORDCORE structures 
  7151.     are inserted. 
  7152.  
  7153.       TRUE 
  7154.          The display is automatically updated after a RECORDCORE structure is 
  7155.          inserted. 
  7156.  
  7157.       FALSE 
  7158.          The application must send the CM_INVALIDATERECORD message after a 
  7159.          RECORDCORE structure is inserted. 
  7160.  
  7161.  
  7162. ΓòÉΓòÉΓòÉ <hidden> RECORDINSERT Parameter - zOrder ΓòÉΓòÉΓòÉ
  7163.  
  7164.  zOrder (ULONG) 
  7165.     Record z-order. 
  7166.  
  7167.     Positions the RECORDCORE structure in z-order, relative to other records in 
  7168.     the container. The values can be: 
  7169.  
  7170.       CMA_TOP 
  7171.          Places a RECORDCORE structure at the top of the z-order. This is the 
  7172.          default value. 
  7173.  
  7174.       CMA_BOTTOM 
  7175.          Places a RECORDCORE structure at the bottom of the z-order. 
  7176.  
  7177.  
  7178. ΓòÉΓòÉΓòÉ <hidden> RECORDINSERT Parameter - cRecordsInsert ΓòÉΓòÉΓòÉ
  7179.  
  7180.  cRecordsInsert (ULONG) 
  7181.     Number of root-level structures. 
  7182.  
  7183.     The number of root-level RECORDCORE structures to be inserted. The 
  7184.     cRecordsInsert field value must be greater than 0. 
  7185.  
  7186.  
  7187. ΓòÉΓòÉΓòÉ 2.69. RECORDITEM ΓòÉΓòÉΓòÉ
  7188.  
  7189. USAGE_RECORD structure. 
  7190.  
  7191. typedef struct _RECORDITEM {
  7192. HWND              hwndCnr;  /*  Container into which the object is inserted. */
  7193. PMINIRECORDCORE   pRecord;  /*  Record pointer within the container. */
  7194. ULONG             ulUser;   /*  For application use. */
  7195.  } RECORDITEM;
  7196.  
  7197. typedef RECORDITEM *PRECORDITEM;
  7198.  
  7199.  
  7200. ΓòÉΓòÉΓòÉ <hidden> RECORDITEM Parameter - hwndCnr ΓòÉΓòÉΓòÉ
  7201.  
  7202.  hwndCnr (HWND) 
  7203.     Container into which the object is inserted. 
  7204.  
  7205.  
  7206. ΓòÉΓòÉΓòÉ <hidden> RECORDITEM Parameter - pRecord ΓòÉΓòÉΓòÉ
  7207.  
  7208.  pRecord (PMINIRECORDCORE) 
  7209.     Record pointer within the container. 
  7210.  
  7211.  
  7212. ΓòÉΓòÉΓòÉ <hidden> RECORDITEM Parameter - ulUser ΓòÉΓòÉΓòÉ
  7213.  
  7214.  ulUser (ULONG) 
  7215.     For application use. 
  7216.  
  7217.  
  7218. ΓòÉΓòÉΓòÉ 2.70. RECTL ΓòÉΓòÉΓòÉ
  7219.  
  7220. Rectangle structure. 
  7221.  
  7222. typedef struct _RECTL {
  7223. LONG   xLeft;    /*  X-coordinate of left-hand edge of rectangle. */
  7224. LONG   yBottom;  /*  Y-coordinate of bottom edge of rectangle. */
  7225. LONG   xRight;   /*  X-coordinate of right-hand edge of rectangle. */
  7226. LONG   yTop;     /*  Y-coordinate of top edge of rectangle. */
  7227.  } RECTL;
  7228.  
  7229. typedef RECTL *PRECTL;
  7230.  
  7231.  
  7232. ΓòÉΓòÉΓòÉ <hidden> RECTL Parameter - xLeft ΓòÉΓòÉΓòÉ
  7233.  
  7234.  xLeft (LONG) 
  7235.     X-coordinate of left-hand edge of rectangle. 
  7236.  
  7237.  
  7238. ΓòÉΓòÉΓòÉ <hidden> RECTL Parameter - yBottom ΓòÉΓòÉΓòÉ
  7239.  
  7240.  yBottom (LONG) 
  7241.     Y-coordinate of bottom edge of rectangle. 
  7242.  
  7243.  
  7244. ΓòÉΓòÉΓòÉ <hidden> RECTL Parameter - xRight ΓòÉΓòÉΓòÉ
  7245.  
  7246.  xRight (LONG) 
  7247.     X-coordinate of right-hand edge of rectangle. 
  7248.  
  7249.  
  7250. ΓòÉΓòÉΓòÉ <hidden> RECTL Parameter - yTop ΓòÉΓòÉΓòÉ
  7251.  
  7252.  yTop (LONG) 
  7253.     Y-coordinate of top edge of rectangle. 
  7254.  
  7255.  
  7256. ΓòÉΓòÉΓòÉ 2.71. SHORT ΓòÉΓòÉΓòÉ
  7257.  
  7258. Signed integer in the range -32 768 through 32 767. 
  7259.  
  7260. #define SHORT short
  7261.  
  7262.  
  7263. ΓòÉΓòÉΓòÉ 2.72. SIZEF ΓòÉΓòÉΓòÉ
  7264.  
  7265. Size structure (FIXED values). 
  7266.  
  7267. typedef struct _SIZEF {
  7268. FIXED   cx;  /*  Width. */
  7269. FIXED   cy;  /*  Height. */
  7270.  } SIZEF;
  7271.  
  7272. typedef SIZEF *PSIZEF;
  7273.  
  7274.  
  7275. ΓòÉΓòÉΓòÉ <hidden> SIZEF Parameter - cx ΓòÉΓòÉΓòÉ
  7276.  
  7277.  cx (FIXED) 
  7278.     Width. 
  7279.  
  7280.  
  7281. ΓòÉΓòÉΓòÉ <hidden> SIZEF Parameter - cy ΓòÉΓòÉΓòÉ
  7282.  
  7283.  cy (FIXED) 
  7284.     Height. 
  7285.  
  7286.  
  7287. ΓòÉΓòÉΓòÉ 2.73. SIZEL ΓòÉΓòÉΓòÉ
  7288.  
  7289. Size structure (LONG values). 
  7290.  
  7291. typedef struct _SIZEL {
  7292. LONG   cx;  /*  Width. */
  7293. LONG   cy;  /*  Height. */
  7294.  } SIZEL;
  7295.  
  7296. typedef SIZEL *PSIZEL;
  7297.  
  7298.  
  7299. ΓòÉΓòÉΓòÉ <hidden> SIZEL Parameter - cx ΓòÉΓòÉΓòÉ
  7300.  
  7301.  cx (LONG) 
  7302.     Width. 
  7303.  
  7304.  
  7305. ΓòÉΓòÉΓòÉ <hidden> SIZEL Parameter - cy ΓòÉΓòÉΓòÉ
  7306.  
  7307.  cy (LONG) 
  7308.     Height. 
  7309.  
  7310.  
  7311. ΓòÉΓòÉΓòÉ 2.74. SORTFASTINFO ΓòÉΓòÉΓòÉ
  7312.  
  7313. Sort record data structure. 
  7314.  
  7315. typedef struct _SORTFASTINFO {
  7316. PFNCOMPARE     pfnCompare;   /*  Pointer to the details view comparison function.                                                                        */
  7317. ULONG          FieldOffset;
  7318. M_WPObject    *Class;
  7319.  } SORTFASTINFO;
  7320.  
  7321. typedef SORTFASTINFO *PSORTFASTINFO;
  7322.  
  7323.  
  7324. ΓòÉΓòÉΓòÉ <hidden> SORTFASTINFO Parameter - pfnCompare ΓòÉΓòÉΓòÉ
  7325.  
  7326.  pfnCompare (PFNCOMPARE) 
  7327.     Pointer to the details view comparison function. 
  7328.  
  7329.  
  7330. ΓòÉΓòÉΓòÉ <hidden> SORTFASTINFO Parameter - FieldOffset ΓòÉΓòÉΓòÉ
  7331.  
  7332.  FieldOffset (ULONG) 
  7333.  
  7334.  
  7335. ΓòÉΓòÉΓòÉ <hidden> SORTFASTINFO Parameter - Class ΓòÉΓòÉΓòÉ
  7336.  
  7337.  Class (M_WPObject *) 
  7338.  
  7339.  
  7340. ΓòÉΓòÉΓòÉ 2.75. SWP ΓòÉΓòÉΓòÉ
  7341.  
  7342. Set-window-position structure. 
  7343.  
  7344. typedef struct _SWP {
  7345. ULONG   fl;                /*  Options. */
  7346. LONG    cy;                /*  Window height. */
  7347. LONG    cx;                /*  Window width. */
  7348. LONG    y;                 /*  Y-coordinate of origin. */
  7349. LONG    x;                 /*  X-coordinate of origin. */
  7350. HWND    hwndInsertBehind;  /*  Window behind which this window is placed. */
  7351. HWND    hwnd;              /*  Window handle. */
  7352. ULONG   ulReserved1;       /*  Reserved value; must be 0. */
  7353. ULONG   ulReserved2;       /*  Reserved value; must be 0. */
  7354.  } SWP;
  7355.  
  7356. typedef SWP *PSWP;
  7357.  
  7358.  
  7359. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - fl ΓòÉΓòÉΓòÉ
  7360.  
  7361.  fl (ULONG) 
  7362.     Options. 
  7363.  
  7364.     Possible values are shown in the following list: 
  7365.  
  7366.       SWP_ACTIVATE 
  7367.  
  7368.       SWP_DEACTIVATE 
  7369.  
  7370.       SWP_HIDE 
  7371.  
  7372.       SWP_MAXIMIZE 
  7373.  
  7374.       SWP_MINIMIZE 
  7375.  
  7376.       SWP_MOVE 
  7377.  
  7378.       SWP_NOADJUST 
  7379.  
  7380.       SWP_NOERASEWINDOW 
  7381.  
  7382.       SWP_NOREDRAW 
  7383.  
  7384.       SWP_RESTORE 
  7385.  
  7386.       SWP_SHOW 
  7387.  
  7388.       SWP_SIZE 
  7389.  
  7390.       SWP_ZORDER 
  7391.  
  7392.  
  7393. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - cy ΓòÉΓòÉΓòÉ
  7394.  
  7395.  cy (LONG) 
  7396.     Window height. 
  7397.  
  7398.  
  7399. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - cx ΓòÉΓòÉΓòÉ
  7400.  
  7401.  cx (LONG) 
  7402.     Window width. 
  7403.  
  7404.  
  7405. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - y ΓòÉΓòÉΓòÉ
  7406.  
  7407.  y (LONG) 
  7408.     Y-coordinate of origin. 
  7409.  
  7410.  
  7411. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - x ΓòÉΓòÉΓòÉ
  7412.  
  7413.  x (LONG) 
  7414.     X-coordinate of origin. 
  7415.  
  7416.  
  7417. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - hwndInsertBehind ΓòÉΓòÉΓòÉ
  7418.  
  7419.  hwndInsertBehind (HWND) 
  7420.     Window behind which this window is placed. 
  7421.  
  7422.  
  7423. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - hwnd ΓòÉΓòÉΓòÉ
  7424.  
  7425.  hwnd (HWND) 
  7426.     Window handle. 
  7427.  
  7428.  
  7429. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - ulReserved1 ΓòÉΓòÉΓòÉ
  7430.  
  7431.  ulReserved1 (ULONG) 
  7432.     Reserved value; must be 0. 
  7433.  
  7434.  
  7435. ΓòÉΓòÉΓòÉ <hidden> SWP Parameter - ulReserved2 ΓòÉΓòÉΓòÉ
  7436.  
  7437.  ulReserved2 (ULONG) 
  7438.     Reserved value; must be 0. 
  7439.  
  7440.  
  7441. ΓòÉΓòÉΓòÉ 2.76. TREEITEMDESC ΓòÉΓòÉΓòÉ
  7442.  
  7443. Structure that contains icons and bit maps used to represent the state of an 
  7444. expanded or collapsed parent item in the tree name view of a container control. 
  7445.  
  7446. typedef struct _TREEITEMDESC {
  7447. HBITMAP    hbmExpanded;    /*  Expanded bit-map handle. */
  7448. HBITMAP    hbmCollapsed;   /*  Collapsed bit-map handle. */
  7449. HPOINTER   hptrExpanded;   /*  Expanded icon handle. */
  7450. HPOINTER   hptrCollapsed;  /*  Collapsed icon handle. */
  7451.  } TREEITEMDESC;
  7452.  
  7453. typedef TREEITEMDESC *PTREEITEMDESC;
  7454.  
  7455.  
  7456. ΓòÉΓòÉΓòÉ <hidden> TREEITEMDESC Parameter - hbmExpanded ΓòÉΓòÉΓòÉ
  7457.  
  7458.  hbmExpanded (HBITMAP) 
  7459.     Expanded bit-map handle. 
  7460.  
  7461.     The handle of the bit map to be used to represent an expanded parent item 
  7462.     in the tree name view. 
  7463.  
  7464.  
  7465. ΓòÉΓòÉΓòÉ <hidden> TREEITEMDESC Parameter - hbmCollapsed ΓòÉΓòÉΓòÉ
  7466.  
  7467.  hbmCollapsed (HBITMAP) 
  7468.     Collapsed bit-map handle. 
  7469.  
  7470.     The handle of the bit map to be used to represent a collapsed parent item 
  7471.     in the tree name view. 
  7472.  
  7473.  
  7474. ΓòÉΓòÉΓòÉ <hidden> TREEITEMDESC Parameter - hptrExpanded ΓòÉΓòÉΓòÉ
  7475.  
  7476.  hptrExpanded (HPOINTER) 
  7477.     Expanded icon handle. 
  7478.  
  7479.     The handle of the icon to be used to represent an expanded parent item in 
  7480.     the tree name view. 
  7481.  
  7482.  
  7483. ΓòÉΓòÉΓòÉ <hidden> TREEITEMDESC Parameter - hptrCollapsed ΓòÉΓòÉΓòÉ
  7484.  
  7485.  hptrCollapsed (HPOINTER) 
  7486.     Collapsed icon handle. 
  7487.  
  7488.     The handle of the icon to be used to represent a collapsed parent item in 
  7489.     the tree name view. 
  7490.  
  7491.  
  7492. ΓòÉΓòÉΓòÉ 2.77. UCHAR ΓòÉΓòÉΓòÉ
  7493.  
  7494. Single-byte unsigned character or unsigned integer in the range 0 through 255. 
  7495.  
  7496. typedef unsigned char UCHAR;
  7497.  
  7498.  
  7499. ΓòÉΓòÉΓòÉ 2.78. ULONG ΓòÉΓòÉΓòÉ
  7500.  
  7501. Unsigned integer in the range 0 through 4 294 967 295. 
  7502.  
  7503. typedef unsigned long ULONG;
  7504.  
  7505.  
  7506. ΓòÉΓòÉΓòÉ 2.79. USEITEM ΓòÉΓòÉΓòÉ
  7507.  
  7508. Use-Item data structure. 
  7509.  
  7510. The USEITEM structure is always followed by a type-specific structure that is 
  7511. indicated by the type field. 
  7512.  
  7513. typedef struct _USEITEM {
  7514. ULONG               type;   /*  The type of this item. */
  7515. struct _USEITEM    *pNext;  /*  Next item in the Use list. */
  7516.  } USEITEM;
  7517.  
  7518. typedef USEITEM *PUSEITEM;
  7519.  
  7520.  
  7521. ΓòÉΓòÉΓòÉ <hidden> USEITEM Parameter - type ΓòÉΓòÉΓòÉ
  7522.  
  7523.  type (ULONG) 
  7524.     The type of this item. 
  7525.  
  7526.     Possible values are: 
  7527.  
  7528.       USAGE_LINK 
  7529.          LINKITEM 
  7530.       USAGE_MEMORY 
  7531.          MEMORYITEM 
  7532.       USAGE_RECORD 
  7533.          RECORDITEM 
  7534.       USAGE_OPENVIEW 
  7535.          VIEWITEM 
  7536.       USAGE_OPENFILE 
  7537.          VIEWFILE 
  7538.  
  7539.  
  7540. ΓòÉΓòÉΓòÉ <hidden> USEITEM Parameter - pNext ΓòÉΓòÉΓòÉ
  7541.  
  7542.  pNext (struct _USEITEM *) 
  7543.     Next item in the Use list. 
  7544.  
  7545.  
  7546. ΓòÉΓòÉΓòÉ 2.80. USHORT ΓòÉΓòÉΓòÉ
  7547.  
  7548. Unsigned integer in the range 0 through 65 535. 
  7549.  
  7550. typedef unsigned short USHORT;
  7551.  
  7552.  
  7553. ΓòÉΓòÉΓòÉ 2.81. VIEWFILE ΓòÉΓòÉΓòÉ
  7554.  
  7555. USAGE_OPENFILE structure. 
  7556.  
  7557. typedef struct _VIEWFILE {
  7558. ULONG             ulMenuId;  /*  Menu ID, if an association or menu page. */
  7559. LHANDLE           handle;    /*  Open handle. */
  7560. HWND              hwndCnr;   /*  System use only (window animation). */
  7561. PMINIRECORDCORE   pRecord;   /*  System use only (window animation). */
  7562.  } VIEWFILE;
  7563.  
  7564. typedef VIEWFILE *PVIEWFILE;
  7565.  
  7566.  
  7567. ΓòÉΓòÉΓòÉ <hidden> VIEWFILE Parameter - ulMenuId ΓòÉΓòÉΓòÉ
  7568.  
  7569.  ulMenuId (ULONG) 
  7570.     Menu ID, if an association or menu page. 
  7571.  
  7572.  
  7573. ΓòÉΓòÉΓòÉ <hidden> VIEWFILE Parameter - handle ΓòÉΓòÉΓòÉ
  7574.  
  7575.  handle (LHANDLE) 
  7576.     Open handle. 
  7577.  
  7578.  
  7579. ΓòÉΓòÉΓòÉ <hidden> VIEWFILE Parameter - hwndCnr ΓòÉΓòÉΓòÉ
  7580.  
  7581.  hwndCnr (HWND) 
  7582.     System use only (window animation). 
  7583.  
  7584.  
  7585. ΓòÉΓòÉΓòÉ <hidden> VIEWFILE Parameter - pRecord ΓòÉΓòÉΓòÉ
  7586.  
  7587.  pRecord (PMINIRECORDCORE) 
  7588.     System use only (window animation). 
  7589.  
  7590.  
  7591. ΓòÉΓòÉΓòÉ 2.82. VIEWITEM ΓòÉΓòÉΓòÉ
  7592.  
  7593. USAGE_OPENVIEW structure. 
  7594.  
  7595. typedef struct _VIEWITEM {
  7596. ULONG             view;         /*  Object view that this represents. */
  7597. LHANDLE           handle;       /*  Open handle. */
  7598. ULONG             ulViewState;  /*  View state flags. */
  7599. HWND              hwndCnr;      /*  System use only (window animation). */
  7600. PMINIRECORDCORE   pRecord;      /*  System use only (window animation). */
  7601.  } VIEWITEM;
  7602.  
  7603. typedef VIEWITEM *PVIEWITEM;
  7604.  
  7605.  
  7606. ΓòÉΓòÉΓòÉ <hidden> VIEWITEM Parameter - view ΓòÉΓòÉΓòÉ
  7607.  
  7608.  view (ULONG) 
  7609.     Object view that this represents. 
  7610.  
  7611.  
  7612. ΓòÉΓòÉΓòÉ <hidden> VIEWITEM Parameter - handle ΓòÉΓòÉΓòÉ
  7613.  
  7614.  handle (LHANDLE) 
  7615.     Open handle. 
  7616.  
  7617.  
  7618. ΓòÉΓòÉΓòÉ <hidden> VIEWITEM Parameter - ulViewState ΓòÉΓòÉΓòÉ
  7619.  
  7620.  ulViewState (ULONG) 
  7621.     View state flags. 
  7622.  
  7623.     Possible values are: 
  7624.  
  7625.       VIEWSTATE_OPENING 
  7626.          The view is being opened. 
  7627.       VIEWSTATE_OBJECTDELETED 
  7628.          The object has been deleted. 
  7629.       VIEWSTATE_USERHIDDEN 
  7630.          The view was hidden by the user. 
  7631.       VIEWSTATE_POPULATING 
  7632.          The view is populating. 
  7633.       VIEWSTATE_USERMINIMIZED 
  7634.          The view was minimized by the user. 
  7635.       VIEWSTATE_CLOSING 
  7636.          The view is closing. 
  7637.       VIEWSTATE_DELETING 
  7638.          The object is being deleted. 
  7639.  
  7640.  
  7641. ΓòÉΓòÉΓòÉ <hidden> VIEWITEM Parameter - hwndCnr ΓòÉΓòÉΓòÉ
  7642.  
  7643.  hwndCnr (HWND) 
  7644.     System use only (window animation). 
  7645.  
  7646.  
  7647. ΓòÉΓòÉΓòÉ <hidden> VIEWITEM Parameter - pRecord ΓòÉΓòÉΓòÉ
  7648.  
  7649.  pRecord (PMINIRECORDCORE) 
  7650.     System use only (window animation). 
  7651.  
  7652.  
  7653. ΓòÉΓòÉΓòÉ 2.83. VOID ΓòÉΓòÉΓòÉ
  7654.  
  7655. A data area of undefined format. 
  7656.  
  7657. #define VOID void
  7658.  
  7659.  
  7660. ΓòÉΓòÉΓòÉ 2.84. WPSRCLASSBLOCK ΓòÉΓòÉΓòÉ
  7661.  
  7662. Save or restore the class block structure. 
  7663.  
  7664. typedef struct _WPSRCLASSBLOCK {
  7665. SHORT    ClassNameLength;  /*  Length of class name. */
  7666. USHORT   IVarLength;       /*  Length of the instance variable information. */
  7667.  } WPSRCLASSBLOCK;
  7668.  
  7669. typedef WPSRCLASSBLOCK *PWPSRCLASSBLOCK*;
  7670.  
  7671.  
  7672. ΓòÉΓòÉΓòÉ <hidden> WPSRCLASSBLOCK Parameter - ClassNameLength ΓòÉΓòÉΓòÉ
  7673.  
  7674.  ClassNameLength (SHORT) 
  7675.     Length of class name. 
  7676.  
  7677.     Includes the null terminator. This must be a short and must be at the 
  7678.     beginning of the structure.  The class name immediately follows the control 
  7679.     block. The first instance variable control block immediately follows this. 
  7680.  
  7681.  
  7682. ΓòÉΓòÉΓòÉ <hidden> WPSRCLASSBLOCK Parameter - IVarLength ΓòÉΓòÉΓòÉ
  7683.  
  7684.  IVarLength (USHORT) 
  7685.     Length of the instance variable information. 
  7686.  
  7687.     Includes the two-byte null terminator. 
  7688.  
  7689.  
  7690. ΓòÉΓòÉΓòÉ 3. Glossary ΓòÉΓòÉΓòÉ
  7691.  
  7692. This glossary defines many of the terms used in this book. It includes terms 
  7693. and definitions from the IBM Dictionary of Computing, as well as terms specific 
  7694. to the OS/2 operating system and the Presentation Manager. It is not a complete 
  7695. glossary for the entire OS/2 operating system; nor is it a complete dictionary 
  7696. of computer terms. 
  7697.  
  7698. Other primary sources for these definitions are: 
  7699.  
  7700.    o  The American National Standard Dictionary for Information Systems, ANSI 
  7701.       X3.172-1990, copyrighted 1990 by the American National Standards 
  7702.       Institute, 11 West 42nd Street, New York, New York 10036. These 
  7703.       definitions are identified by the symbol (A) after the definition. 
  7704.  
  7705.    o  The Information Technology Vocabulary, developed by Subcommittee 1, Joint 
  7706.       Technical Committee 1, of the International Organization for 
  7707.       Standardization and the International Electrotechnical Commission 
  7708.       (ISO/IEC JTC1/SC1). Definitions of published parts of this vocabulary are 
  7709.       identified by the symbol (I) after the definition; definitions taken from 
  7710.       draft international standards, committee drafts, and working papers being 
  7711.       developed by ISO/IEC JTC1/SC1 are identified by the symbol (T) after the 
  7712.       definition, indicating that final agreement has not yet been reached 
  7713.       among the participating National Bodies of SC1. 
  7714.  
  7715.  
  7716. ΓòÉΓòÉΓòÉ 3.1. Glossary Listing ΓòÉΓòÉΓòÉ
  7717.  
  7718. Select a starting letter of glossary terms: 
  7719.  
  7720.  A    N 
  7721.  B    O 
  7722.  C    P 
  7723.  D    Q 
  7724.  E    R 
  7725.  F    S 
  7726.  G    T 
  7727.  H    U 
  7728.  I    V 
  7729.  J    W 
  7730.  K    X 
  7731.  L    Y 
  7732.  M    Z 
  7733.  
  7734.  
  7735. ΓòÉΓòÉΓòÉ <hidden> Glossary - A ΓòÉΓòÉΓòÉ
  7736.  
  7737.  accelerator  In SAA Common User Access architecture, a key or combination of 
  7738.    keys that invokes an application-defined function. 
  7739.  
  7740.  accelerator table  A table used to define which key strokes are treated as 
  7741.    accelerators and the commands they are translated into. 
  7742.  
  7743.  access mode  The manner in which an application gains access to a file it has 
  7744.    opened. Examples of access modes are read-only, write-only, and read/write. 
  7745.  
  7746.  access permission  All access rights that a user has regarding an object. (I)
  7747.  
  7748.  action  One of a set of defined tasks that a computer performs. Users request 
  7749.    the application to perform an action in several ways, such as typing a 
  7750.    command, pressing a function key, or selecting the action name from an 
  7751.    action bar or menu. 
  7752.  
  7753.  action bar  In SAA Common User Access architecture, the area at the top of a 
  7754.    window that contains choices that give a user access to actions available in 
  7755.    that window. 
  7756.  
  7757.  action point  The current position on the screen at which the pointer is 
  7758.    pointing. Contrast with hot spot and input focus. 
  7759.  
  7760.  active program  A program currently running on the computer.  An active 
  7761.    program can be interactive (running and receiving input from the user) or 
  7762.    noninteractive (running but not receiving input from the user). See also 
  7763.    interactive program and noninteractive program. 
  7764.  
  7765.  active window  The window with which the user is currently interacting. 
  7766.  
  7767.  address space  (1) The range of addresses available to a program. (A)  (2) The 
  7768.    area of virtual storage available for a particular job. 
  7769.  
  7770.  alphanumeric video output  Output to the logical video buffer when the video 
  7771.    adapter is in text mode and the logical video buffer is addressed by an 
  7772.    application as a rectangular array of character cells. 
  7773.  
  7774.  American National Standard Code for Information Interchange  The standard 
  7775.    code, using a coded character set consisting of 7-bit coded characters (8 
  7776.    bits including parity check), that is used for information interchange among 
  7777.    data processing systems, data communication systems, and associated 
  7778.    equipment. The ASCII set consists of control characters and graphic 
  7779.    characters. (A) 
  7780.  
  7781.    Note:  IBM has defined an extension to ASCII code (characters 128-255). 
  7782.  
  7783.  anchor  A window procedure that handles Presentation Manager* message 
  7784.    conversions between an icon procedure and an application. 
  7785.  
  7786.  anchor block  An area of Presentation-Manager-internal resources to allocated 
  7787.    process or thread that calls WinInitialize. 
  7788.  
  7789.  anchor point  A point in a window used by a program designer or by a window 
  7790.    manager to position a subsequently appearing window. 
  7791.  
  7792.  ANSI  American National Standards Institute. 
  7793.  
  7794.  APA  All points addressable. 
  7795.  
  7796.  API  Application programming interface. 
  7797.  
  7798.  application  A collection of software components used to perform specific 
  7799.    types of work on a computer; for example, a payroll application, an airline 
  7800.    reservation application, a network application. 
  7801.  
  7802.  application object  In SAA Advanced Common User Access architecture, a form 
  7803.    that an application provides for a user; for example, a spreadsheet form. 
  7804.    Contrast with user object. 
  7805.  
  7806.  application programming interface (API)  A functional interface supplied by 
  7807.    the operating system or by a separately orderable licensed program that 
  7808.    allows an application program written in a high-level language to use 
  7809.    specific data or functions of the operating system or the licensed program. 
  7810.  
  7811.  application-modal  Pertaining to a message box or dialog box for which 
  7812.    processing must be completed before further interaction with any other 
  7813.    window owned by the same application may take place. 
  7814.  
  7815.  area  In computer graphics, a filled shape such as a solid rectangle. 
  7816.  
  7817.  ASCII  American National Standard Code for Information Interchange. 
  7818.  
  7819.  ASCIIZ  A string of ASCII characters that is terminated with a byte containing 
  7820.    the value 0. 
  7821.  
  7822.  aspect ratio  In computer graphics, the width-to-height ratio of an area, 
  7823.    symbol, or shape. 
  7824.  
  7825.  asynchronous (ASYNC)  (1) Pertaining to two or more processes that do not 
  7826.    depend upon the occurrence of specific events such as common timing 
  7827.    signals. (T)  (2) Without regular time relationship;  unexpected or 
  7828.    unpredictable with respect to the execution of program instructions. See 
  7829.    also synchronous. 
  7830.  
  7831.  atom  A constant that represents a string. As soon as a string has been 
  7832.    defined as an atom, the atom can be used in place of the string to save 
  7833.    space. Strings are associated with their respective atoms in an atom table. 
  7834.    See also integer atom. 
  7835.  
  7836.  atom table  A table used to relate atoms with the strings that they represent. 
  7837.    Also in the table is the mechanism by which the presence of a string can be 
  7838.    checked. 
  7839.  
  7840.  atomic operation  An operation that completes its work on an object before 
  7841.    another operation can be performed on the same object. 
  7842.  
  7843.  attribute  A characteristic or property that can be controlled, usually to 
  7844.    obtain a required appearance;  for example, the color of a line. See also 
  7845.    graphics attributes and segment attributes. 
  7846.  
  7847.  automatic link  In Information Presentation Facility (IPF), a link that begins 
  7848.    a chain reaction at the primary window. When the user selects the primary 
  7849.    window, an automatic link is activated to display secondary windows. 
  7850.  
  7851.  AVIO  Advanced Video Input/Output. 
  7852.  
  7853.  
  7854. ΓòÉΓòÉΓòÉ <hidden> Glossary - B ΓòÉΓòÉΓòÉ
  7855.  
  7856.  B╨Æzier curve  (1) A mathematical technique of specifying smooth continous 
  7857.    lines and surfaces, which require a starting point and a finishing point 
  7858.    with several intermediate points that influence or control the path of the 
  7859.    linking curve. Named after Dr. P. B╨Æzier. (2) (D of C) In the AIX Graphics 
  7860.    Library, a cubic spline approximation to a set of four control points that 
  7861.    passes through the first and fourth control points and that has a continuous 
  7862.    slope where two spline segments meet. Named after Dr. P. B╨Æzier. 
  7863.  
  7864.  background  (1) In multiprogramming, the conditions under which low-priority 
  7865.    programs are executed. Contrast with foreground. (2) An active session that 
  7866.    is not currently displayed on the screen. 
  7867.  
  7868.  background color  The color in which the background of a graphic primitive is 
  7869.    drawn. 
  7870.  
  7871.  background mix  An attribute that determines how the background of a graphic 
  7872.    primitive is combined with the existing color of the graphics presentation 
  7873.    space. Contrast with mix. 
  7874.  
  7875.  background program  In multiprogramming, a program that executes with a low 
  7876.    priority. Contrast with foreground program. 
  7877.  
  7878.  bit map  A representation in memory of the data displayed on an APA device, 
  7879.    usually the screen. 
  7880.  
  7881.  block  (1) A string of data elements recorded or transmitted as a unit. The 
  7882.    elements may be characters, words, or logical records. (T)  (2) To record 
  7883.    data in a block. (3) A collection of contiguous records recorded as a unit. 
  7884.    Blocks are separated by interblock gaps and each block may contain one or 
  7885.    more records. (A)
  7886.  
  7887.  block device  A storage device that performs I/O operations on blocks of data 
  7888.    called sectors. Data on block devices can be randomly accessed. Block 
  7889.    devices are designated by a drive letter (for example, C:). 
  7890.  
  7891.  blocking mode  A condition set by an application that determines when its 
  7892.    threads might block. For example, an application might set the Pipemode 
  7893.    parameter for the DosCreateNPipe function so that its threads perform I/O 
  7894.    operations to the named pipe block when no data is available. 
  7895.  
  7896.  border  A visual indication (for example, a separator line or a background 
  7897.    color) of the boundaries of a window. 
  7898.  
  7899.  boundary determination  An operation used to compute the size of the smallest 
  7900.    rectangle that encloses a graphics object on the screen. 
  7901.  
  7902.  breakpoint  (1) A point in a computer program where execution may be halted. A 
  7903.    breakpoint is usually at the beginning of an instruction where halts, caused 
  7904.    by external intervention, are convenient for resuming execution. (T)  (2) A 
  7905.    place in a program, specified by a command or a condition, where the system 
  7906.    halts execution and gives control to the workstation user or to a specified 
  7907.    program. 
  7908.  
  7909.  broken pipe  When all of the handles that access one end of a pipe have been 
  7910.    closed. 
  7911.  
  7912.  bucket  One or more fields in which the result of an operation is kept. 
  7913.  
  7914.  buffer  (1) A portion of storage used to hold input or output data 
  7915.    temporarily. (2) To allocate and schedule the use of buffers. (A)
  7916.  
  7917.  button  A mechanism used to request or initiate an action. See also barrel 
  7918.    buttons, bezel buttons, mouse button, push button, and radio button. 
  7919.  
  7920.  byte pipe  Pipes that handle data as byte streams. All unnamed pipes are byte 
  7921.    pipes. Named pipes can be byte pipes or message pipes. See byte stream. 
  7922.  
  7923.  byte stream  Data that consists of an unbroken stream of bytes. 
  7924.  
  7925.  
  7926. ΓòÉΓòÉΓòÉ <hidden> Glossary - C ΓòÉΓòÉΓòÉ
  7927.  
  7928.  cache  A high-speed buffer storage that contains frequently accessed 
  7929.    instructions and data; it is used to reduce access time. 
  7930.  
  7931.  cached micro presentation space  A presentation space from a 
  7932.    Presentation-Manager-owned store of micro presentation spaces. It can be 
  7933.    used for drawing to a window only, and must be returned to the store when 
  7934.    the task is complete. 
  7935.  
  7936.  CAD  Computer-Aided Design. 
  7937.  
  7938.  call  (1) The action of bringing a computer program, a routine, or a 
  7939.    subroutine into effect, usually by specifying the entry conditions and 
  7940.    jumping to an entry point. (I)  (A)  (2) To transfer control to a procedure, 
  7941.    program, routine, or subroutine. 
  7942.  
  7943.  calling sequence  A sequence of instructions together with any associated data 
  7944.    necessary to execute a call. (T)
  7945.  
  7946.  Cancel  An action that removes the current window or menu without processing 
  7947.    it, and returns the previous window. 
  7948.  
  7949.  cascaded menu  In the OS/2 operating system, a menu that appears when the 
  7950.    arrow to the right of a cascading choice is selected. It contains a set of 
  7951.    choices that are related to the cascading choice. Cascaded menus are used to 
  7952.    reduce the length of a menu. See also cascading choice. 
  7953.  
  7954.  cascading choice  In SAA Common User Access architecture, a choice in a menu 
  7955.    that, when selected, produces a cascaded menu containing other choices.  An 
  7956.    arrow () appears to the right of the cascading choice. 
  7957.  
  7958.  CASE statement  In PM programming, provides the body of a window procedure. 
  7959.    There is usually one CASE statement for each message type supported by an 
  7960.    application. 
  7961.  
  7962.  CGA  Color graphics adapter. 
  7963.  
  7964.  chained list  A list in which the data elements may be dispersed but in which 
  7965.    each data element contains information for locating the 
  7966.    next. (T)Synonymous with linked list. 
  7967.  
  7968.  character  A letter, digit, or other symbol. 
  7969.  
  7970.  character box  In computer graphics, the boundary that defines, in world 
  7971.    coordinates, the horizontal and vertical space occupied by a single 
  7972.    character from a character set. See also character mode. Contrast with 
  7973.    character cell. 
  7974.  
  7975.  character cell  The physical, rectangular space in which any single character 
  7976.    is displayed on a screen or printer device. Position is addressed by row and 
  7977.    column coordinates. Contrast with character box. 
  7978.  
  7979.  character code  The means of addressing a character in a character set, 
  7980.    sometimes called code point. 
  7981.  
  7982.  character device  A device that performs I/O operations on one character at a 
  7983.    time. Because character devices view data as a stream of bytes, 
  7984.    character-device data cannot be randomly accessed. Character devices include 
  7985.    the keyboard, mouse, and printer, and are referred to by name. 
  7986.  
  7987.  character mode  A mode that, in conjunction with the font type, determines the 
  7988.    extent to which graphics characters are affected by the character box, 
  7989.    shear, and angle attributes. 
  7990.  
  7991.  character set  (1) An ordered set of unique representations called characters; 
  7992.    for example, the 26 letters of English alphabet, Boolean 0 and 1, the set of 
  7993.    symbols in the Morse code, and the 128 ASCII characters. (A)  (2) All the 
  7994.    valid characters for a programming language or for a computer system. (3) A 
  7995.    group of characters used for a specific reason; for example, the set of 
  7996.    characters a printer can print. 
  7997.  
  7998.  check box  In SAA Advanced Common User Access architecture, a square box with 
  7999.    associated text that represents a choice. When a user selects a choice, an X 
  8000.    appears in the check box to indicate that the choice is in effect. The user 
  8001.    can clear the check box by selecting the choice again. Contrast with radio 
  8002.    button. 
  8003.  
  8004.  check mark   (1) (D of C) In SAA Advanced Common User Access architecture, a 
  8005.    symbol that shows that a choice is currently in effect. (2) The symbol that 
  8006.    is used to indicate a selected item on a pull-down menu. 
  8007.  
  8008.  child process  In the OS/2 operating system, a process started by another 
  8009.    process, which is called the parent process. Contrast with parent process. 
  8010.  
  8011.  child window  A window that appears within the border of its parent window 
  8012.    (either a primary window or another child window). When the parent window is 
  8013.    resized, moved, or destroyed, the child window also is resized, moved, or 
  8014.    destroyed; however, the child window can be moved or resized independently 
  8015.    from the parent window, within the boundaries of the parent window. Contrast 
  8016.    with parent window. 
  8017.  
  8018.  choice  (1) An option that can be selected. The choice can be presented as 
  8019.    text, as a symbol (number or letter), or as an icon (a pictorial symbol). 
  8020.    (2) (D of C) In SAA Common User Access architecture, an item that a user can 
  8021.    select. 
  8022.  
  8023.  chord  (1) To press more than one button on a pointing device while the 
  8024.    pointer is within the limits that the user has specified for the operating 
  8025.    environment. (2) (D of C) In graphics, a short line segment whose end points 
  8026.    lie on a circle. Chords are a means for producing a circular image from 
  8027.    straight lines. The higher the number of chords per circle, the smoother the 
  8028.    circular image. 
  8029.  
  8030.  class  In object-oriented design or programming, a group of objects that share 
  8031.    a common definition and that therefore share common properties, operations, 
  8032.    and behavior. Members of the group are called instances of the class. 
  8033.  
  8034.  class method  In System Object Model, an action that can be performed on a 
  8035.    class object. Synonymous with factory method. 
  8036.  
  8037.  class object  In System Object Model, the run-time implementation of a class. 
  8038.  
  8039.  class style  The set of properties that apply to every window in a window 
  8040.    class. 
  8041.  
  8042.  client  (1) A functional unit that receives shared services from a 
  8043.    server. (T)  (2) A user, as in a client process that uses a named pipe or 
  8044.    queue that is created and owned by a server process. 
  8045.  
  8046.  client area  The part of the window, inside the border, that is below the menu 
  8047.    bar. It is the user's work space, where a user types information and selects 
  8048.    choices from selection fields.  In primary windows, it is where an 
  8049.    application programmer presents the objects that a user works on. 
  8050.  
  8051.  client program  An application that creates and manipulates instances of 
  8052.    classes. 
  8053.  
  8054.  client window  The window in which the application displays output and 
  8055.    receives input. This window is located inside the frame window, under the 
  8056.    window title bar and any menu bar, and within any scroll bars. 
  8057.  
  8058.  clip limits  The area of the paper that can be reached by a printer or 
  8059.    plotter. 
  8060.  
  8061.  clipboard  In SAA Common User Access architecture, an area of computer memory, 
  8062.    or storage, that temporarily holds data. Data in the clipboard is available 
  8063.    to other applications. 
  8064.  
  8065.  clipping  In computer graphics, removing those parts of a display image that 
  8066.    lie outside a given boundary. (I)  (A)
  8067.  
  8068.  clipping area  The area in which the window can paint. 
  8069.  
  8070.  clipping path  A clipping boundary in world-coordinate space. 
  8071.  
  8072.  clock tick  The minimum unit of time that the system tracks. If the system 
  8073.    timer currently counts at a rate of X Hz, the system tracks the time every 
  8074.    1/X of a second. Also known as time tick. 
  8075.  
  8076.  CLOCK$  Character-device name reserved for the system clock. 
  8077.  
  8078.  code page  An assignment of graphic characters and control-function meanings 
  8079.    to all code points. 
  8080.  
  8081.  code point  (1) Synonym for character code. (2) (D of C) A 1-byte code 
  8082.    representing one of 256 potential characters. 
  8083.  
  8084.  code segment  An executable section of programming code within a load module. 
  8085.  
  8086.  color dithering  See dithering. 
  8087.  
  8088.  color graphics adapter (CGA)  An adapter that simultaneously provides four 
  8089.    colors and is supported by all IBM Personal Computer and Personal System/2 
  8090.    models. 
  8091.  
  8092.  command  The name and parameters associated with an action that a program can 
  8093.    perform. 
  8094.  
  8095.  command area  An area composed of a command field prompt and a command entry 
  8096.    field. 
  8097.  
  8098.  command entry field  An entry field in which users type commands. 
  8099.  
  8100.  command line  On a display screen, a display line, sometimes at the bottom of 
  8101.    the screen, in which only commands can be entered. 
  8102.  
  8103.  command mode  A state of a system or device in which the user can enter 
  8104.    commands. 
  8105.  
  8106.  command prompt  A field prompt showing the location of the command entry field 
  8107.    in a panel. 
  8108.  
  8109.  Common Programming Interface (CPI)  Definitions of those application 
  8110.    development languages and services that have, or are intended to have, 
  8111.    implementations on and a high degree of commonality across the SAA 
  8112.    environments. One of the three SAA architectural areas. See also Common User 
  8113.    Access architecture. 
  8114.  
  8115.  Common User Access (CUA) architecture   Guidelines for the dialog between a 
  8116.    human and a workstation or terminal. One of the three SAA architectural 
  8117.    areas. See also Common Programming Interface. 
  8118.  
  8119.  compile  To translate a program written in a higher-level programming language 
  8120.    into a machine language program. 
  8121.  
  8122.  composite window  A window composed of other windows (such as a frame window, 
  8123.    frame-control windows, and a client window) that are kept together as a unit 
  8124.    and that interact with each other. 
  8125.  
  8126.  computer-aided design (CAD)  The use of a computer to design or change a 
  8127.    product, tool, or machine, such as using a computer for drafting or 
  8128.    illustrating. 
  8129.  
  8130.  COM1, COM2, COM3  Character-device names reserved for serial ports 1 through 
  8131.    3. 
  8132.  
  8133.  CON  Character-device name reserved for the console keyboard and screen. 
  8134.  
  8135.  conditional cascaded menu  A pull-down menu associated with a menu item that 
  8136.    has a cascade mini-push button beside it in an object's pop-up menu. The 
  8137.    conditional cascaded menu is displayed when the user selects the mini-push 
  8138.    button. 
  8139.  
  8140.  container  In SAA Common User Access architecture, an object that holds other 
  8141.    objects. A folder is an example of a container object. See also folder and 
  8142.    object. 
  8143.  
  8144.  contextual help  In SAA Common User Access Architecture, help that gives 
  8145.    specific information about the item the cursor is on. The help is contextual 
  8146.    because it provides information about a specific item as it is currently 
  8147.    being used. Contrast with extended help. 
  8148.  
  8149.  contiguous  Touching or joining at a common edge or boundary, for example, an 
  8150.    unbroken consecutive series of storage locations. 
  8151.  
  8152.  control  In SAA Advanced Common User Access architecture, a component of the 
  8153.    user interface that allows a user to select choices or type information; for 
  8154.    example, a check box, an entry field, a radio button. 
  8155.  
  8156.  control area  A storage area used by a computer program to hold control information. (I)  (A)
  8157.  
  8158.  Control Panel  In the Presentation Manager, a program used to set up user 
  8159.    preferences that act globally across the system. 
  8160.  
  8161.  Control Program  (1) The basic functions of the operating system, including 
  8162.    DOS emulation and the support for keyboard, mouse, and video input/output. 
  8163.    (2) A computer program designed to schedule and to supervise the execution 
  8164.    of programs of a computer system. (I)  (A)
  8165.  
  8166.  control window  A window that is used as part of a composite window to perform 
  8167.    simple input and output tasks. Radio buttons and check boxes are examples. 
  8168.  
  8169.  control word  An instruction within a document that identifies its parts or 
  8170.    indicates how to format the document. 
  8171.  
  8172.  coordinate space  A two-dimensional set of points used to generate output on a 
  8173.    video display of printer. 
  8174.  
  8175.  Copy  A choice that places onto the clipboard, a copy of what the user has 
  8176.    selected. See also Cut and Paste. 
  8177.  
  8178.  correlation  The action of determining which element or object within a 
  8179.    picture is at a given position on the display. This follows a pick 
  8180.    operation. 
  8181.  
  8182.  coverpage window  A window in which the application's help information is 
  8183.    displayed. 
  8184.  
  8185.  CPI  Common Programming Interface. 
  8186.  
  8187.  critical extended attribute  An extended attribute that is necessary for the 
  8188.    correct operation of the system or a particular application. 
  8189.  
  8190.  critical section  (1) In programming languages, a part of an asynchronous 
  8191.    procedure that cannot be executed simultaneously with a certain part of 
  8192.    another asynchronous procedure. (I)
  8193.  
  8194.    Note:  Part of the other asynchronous procedure also is a critical section. 
  8195.    (2) A section of code that is not reentrant; that is, code that can be 
  8196.    executed by only one thread at a time. 
  8197.  
  8198.  CUA architecture  Common User Access architecture. 
  8199.  
  8200.  current position  In computer graphics, the position, in user coordinates, 
  8201.    that becomes the starting point for the next graphics routine, if that 
  8202.    routine does not explicitly specify a starting point. 
  8203.  
  8204.  cursor  A symbol displayed on the screen and associated with an input device. 
  8205.    The cursor indicates where input from the device will be placed. Types of 
  8206.    cursors include text cursors, graphics cursors, and selection cursors. 
  8207.    Contrast with pointer and input focus. 
  8208.  
  8209.  Cut  In SAA Common User Access architecture, a choice that removes a selected 
  8210.    object, or a part of an object, to the clipboard, usually compressing the 
  8211.    space it occupied in a window. See also Copy and Paste. 
  8212.  
  8213.  
  8214. ΓòÉΓòÉΓòÉ <hidden> Glossary - D ΓòÉΓòÉΓòÉ
  8215.  
  8216.  daisy chain  A method of device interconnection for determining interrupt 
  8217.    priority by connecting the interrupt sources serially. 
  8218.  
  8219.  data segment  A nonexecutable section of a program module; that is, a section 
  8220.    of a program that contains data definitions. 
  8221.  
  8222.  data structure  The syntactic structure of symbolic expressions and their 
  8223.    storage-allocation characteristics. (T)
  8224.  
  8225.  data transfer  The movement of data from one object to another by way of the 
  8226.    clipboard or by direct manipulation. 
  8227.  
  8228.  DBCS  Double-byte character set. 
  8229.  
  8230.  DDE  Dynamic data exchange. 
  8231.  
  8232.  deadlock  (1) Unresolved contention for the use of a resource. (2) An error 
  8233.    condition in which processing cannot continue because each of two elements 
  8234.    of the process is waiting for an action by, or a response from, the other. 
  8235.    (3) An impasse that occurs when multiple processes are waiting for the 
  8236.    availability of a resource that will not become available because it is 
  8237.    being held by another process that is in a similar wait state. 
  8238.  
  8239.  debug  To detect, diagnose, and eliminate errors in programs. (T)
  8240.  
  8241.  decipoint  In printing, one tenth of a point.  There are 72 points in an inch. 
  8242.  
  8243.  default procedure  A function provided by the Presentation Manager Interface 
  8244.    that may be used to process standard messages from dialogs or windows. 
  8245.  
  8246.  default value  A value assumed when no value has been specified. Synonymous 
  8247.    with assumed value. For example, in the graphics programming interface, the 
  8248.    default line-type is `solid'. 
  8249.  
  8250.  definition list  A type of list that pairs a term and its description. 
  8251.  
  8252.  delta  An application-defined threshold, or number of container items, from 
  8253.    either end of the list. 
  8254.  
  8255.  descendant  See child process. 
  8256.  
  8257.  descriptive text  Text used in addition to a field prompt to give more 
  8258.    information about a field. 
  8259.  
  8260.  Deselect all  A choice that cancels the selection of all of the objects that 
  8261.    have been selected in that window. 
  8262.  
  8263.  Desktop Manager  In the Presentation Manager, a window that displays a list of 
  8264.    groups of programs, each of which can be started or stopped. 
  8265.  
  8266.  desktop window  The window, corresponding to the physical device, against 
  8267.    which all other types of windows are established. 
  8268.  
  8269.  detached process  A background process that runs independent of the parent 
  8270.    process. 
  8271.  
  8272.  detent  A point on a slider that represents an exact value to which a user can 
  8273.    move the slider arm. 
  8274.  
  8275.  device context  A logical description of a data destination such as memory, 
  8276.    metafile, display, printer, or plotter. See also direct device context, 
  8277.    information device context, memory device context, metafile device context, 
  8278.    queued device context, and screen device context. 
  8279.  
  8280.  device driver  A file that contains the code needed to attach and use a device 
  8281.    such as a display, printer, or plotter. 
  8282.  
  8283.  device space  (1) Coordinate space in which graphics are assembled after all 
  8284.    GPI transformations have been applied. Device space is defined in 
  8285.    device-specific units. (2) (D of C) In computer graphics, a space defined by 
  8286.    the complete set of addressable points of a display device. (A)
  8287.  
  8288.  dialog  The interchange of information between a computer and its user through 
  8289.    a sequence of requests by the user and the presentation of responses by the 
  8290.    computer. 
  8291.  
  8292.  dialog box  In SAA Advanced Common User Access architecture, a movable window, 
  8293.    fixed in size, containing controls that a user uses to provide information 
  8294.    required by an application so that it can continue to process a user 
  8295.    request. See also message box, primary window, secondary window. Also known 
  8296.    as a pop-up window. 
  8297.  
  8298.  Dialog Box Editor  A WYSIWYG editor that creates dialog boxes for 
  8299.    communicating with the application user. 
  8300.  
  8301.  dialog item  A component (for example, a menu or a button) of a dialog box. 
  8302.    Dialog items are also used when creating dialog templates. 
  8303.  
  8304.  dialog procedure  A dialog window that is controlled by a window procedure. It 
  8305.    is responsible for responding to all messages sent to the dialog window. 
  8306.  
  8307.  dialog tag language  A markup language used by the DTL compiler to create 
  8308.    dialog objects. 
  8309.  
  8310.  dialog template  The definition of a dialog box, which contains details of its 
  8311.    position, appearance, and window ID, and the window ID of each of its child 
  8312.    windows. 
  8313.  
  8314.  direct device context  A logical description of a data destination that is a 
  8315.    device other than the screen (for example, a printer or plotter), and where 
  8316.    the output is not to go through the spooler. Its purpose is to satisfy 
  8317.    queries. See also device context. 
  8318.  
  8319.  direct manipulation  The user's ability to interact with an object by using 
  8320.    the mouse, typically by dragging an object around on the Desktop and 
  8321.    dropping it on other objects. 
  8322.  
  8323.  direct memory access (DMA)  A technique for moving data directly between main 
  8324.    storage and peripheral equipment without requiring processing of the data by 
  8325.    the processing unit.(T)
  8326.  
  8327.  directory  A type of file containing the names and controlling information for 
  8328.    other files or other directories. 
  8329.  
  8330.  display point  Synonym for pel. 
  8331.  
  8332.  dithering  (1) The process used in color displays whereby every other pel is 
  8333.    set to one color, and the intermediate pels are set to another. Together 
  8334.    they produce the effect of a third color at normal viewing distances. This 
  8335.    process can only be used on solid areas of color; it does not work, for 
  8336.    example, on narrow lines. (2) (D of C ) In computer graphics, a technique of 
  8337.    interleaving dark and light pixels so that the resulting image looks 
  8338.    smoothly shaded when viewed from a distance. 
  8339.  
  8340.  DMA  Direct memory access. 
  8341.  
  8342.  DOS Protect Mode Interface (DPMI)  An interface between protect mode and real 
  8343.    mode programs. 
  8344.  
  8345.  double-byte character set (DBCS)  A set of characters in which each character 
  8346.    is represented by two bytes.  Languages such as Japanese, Chinese, and 
  8347.    Korean, which contain more characters than can be represented by 256 code 
  8348.    points, require double-byte character sets. Since each character requires 
  8349.    two bytes, the entering, displaying, and printing of DBCS characters 
  8350.    requires hardware and software that can support DBCS. 
  8351.  
  8352.  doubleword  A contiguous sequence of bits or characters that comprises two 
  8353.    computer words and is capable of being addressed as a unit. (A)
  8354.  
  8355.  DPMI  DOS Protect Mode Interface. 
  8356.  
  8357.  drag  In SAA Common User Access, to use a pointing device to move an object; 
  8358.    for example, clicking on a window border, and dragging it to make the window 
  8359.    larger. 
  8360.  
  8361.  dragging  (1) In computer graphics, moving an object on the display screen as 
  8362.    if it were attached to the pointer. (2) (D of C) In computer graphics, 
  8363.    moving one or more segments on a display surface by translating. (I)  (A)
  8364.  
  8365.  drawing chain  See segment chain. 
  8366.  
  8367.  drop  To fix the position of an object that is being dragged, by releasing the 
  8368.    select button of the pointing device. 
  8369.  
  8370.  drop  To fix the position of an object that is being dragged, by releasing the 
  8371.    select button of the pointing device. See also drag. 
  8372.  
  8373.  DTL  Dialog tag language. 
  8374.  
  8375.  dual-boot function  A feature of the OS/2 operating system that allows the 
  8376.    user to start DOS from within the operating system, or an OS/2 session from 
  8377.    within DOS. 
  8378.  
  8379.  duplex  Pertaining to communication in which data can be sent and received at 
  8380.    the same time. Synonymous with full duplex. 
  8381.  
  8382.  dynamic data exchange (DDE)  A message protocol used to communicate between 
  8383.    applications that share data. The protocol uses shared memory as the means 
  8384.    of exchanging data between applications. 
  8385.  
  8386.  dynamic data formatting  A formatting procedure that enables you to 
  8387.    incorporate text, bit maps or metafiles in an IPF window at execution time. 
  8388.  
  8389.  dynamic link library  A collection of executable programming code and data 
  8390.    that is bound to an application at load time or run time, rather than during 
  8391.    linking. The programming code and data in a dynamic link library can be 
  8392.    shared by several applications simultaneously. 
  8393.  
  8394.  dynamic linking  The process of resolving external references in a program 
  8395.    module at load time or run time rather than during linking. 
  8396.  
  8397.  dynamic segments  Graphics segments drawn in exclusive-OR mix mode so that 
  8398.    they can be moved from one screen position to another without affecting the 
  8399.    rest of the displayed picture. 
  8400.  
  8401.  dynamic storage  (1) A device that stores data in a manner that permits the 
  8402.    data to move or vary with time such that the specified data is not always 
  8403.    available for recovery. (A)  (2) A storage in which the cells require 
  8404.    repetitive application of control signals in order to retain stored data. 
  8405.    Such repetitive application of the control signals is called a refresh 
  8406.    operation. A dynamic storage may use static addressing or sensing 
  8407.    circuits. (A)  (3) See also static storage. 
  8408.  
  8409.  dynamic time slicing  Varies the size of the time slice depending on system 
  8410.    load and paging activity. 
  8411.  
  8412.  dynamic-link module  A module that is linked at load time or run time. 
  8413.  
  8414.  
  8415. ΓòÉΓòÉΓòÉ <hidden> Glossary - E ΓòÉΓòÉΓòÉ
  8416.  
  8417.  EBCDIC  Extended binary-coded decimal interchange code. A coded character set 
  8418.    consisting of 8-bit coded characters (9 bits including parity check), used 
  8419.    for information interchange among data processing systems, data 
  8420.    communications systems, and associated equipment. 
  8421.  
  8422.  edge-triggered  Pertaining to an event semaphore that is posted then reset 
  8423.    before a waiting thread gets a chance to run. The semaphore is considered to 
  8424.    be posted for the rest of that thread's waiting period; the thread does not 
  8425.    have to wait for the semaphore to be posted again. 
  8426.  
  8427.  EGA  Extended graphics adapter. 
  8428.  
  8429.  element  An entry in a graphics segment that comprises one or more graphics 
  8430.    orders and that is addressed by the element pointer. 
  8431.  
  8432.  EMS  Expanded Memory Specification. 
  8433.  
  8434.  encapsulation  Hiding an object's implementation, that is, its private, 
  8435.    internal data and methods. Private variables and methods are accessible only 
  8436.    to the object that contains them. 
  8437.  
  8438.  entry field  In SAA Common User Access architecture, an area where a user 
  8439.    types information. Its boundaries are usually indicated. See also selection 
  8440.    field. 
  8441.  
  8442.  entry panel  A defined panel type containing one or more entry fields and 
  8443.    protected information such as headings, prompts, and explanatory text. 
  8444.  
  8445.  entry-field control  The component of a user interface that provides the means 
  8446.    by which the application receives data entered by the user in an entry 
  8447.    field. When it has the input focus, the entry field displays a flashing 
  8448.    pointer at the position where the next typed character will go. 
  8449.  
  8450.  environment segment  The list of environment variables and their values for a 
  8451.    process. 
  8452.  
  8453.  environment strings  ASCII text strings that define the value of environment 
  8454.    variables. 
  8455.  
  8456.  environment variables  Variables that describe the execution environment of a 
  8457.    process. These variables are named by the operating system or by the 
  8458.    application. Environment variables named by the operating system are PATH, 
  8459.    DPATH, INCLUDE, INIT, LIB, PROMPT, and TEMP. The values of environment 
  8460.    variables are defined by the user in the CONFIG.SYS file, or by using the 
  8461.    SET command at the OS/2 command prompt. 
  8462.  
  8463.  error message  An indication that an error has been detected. (A)
  8464.  
  8465.  event semaphore  A semaphore that enables a thread to signal a waiting thread 
  8466.    or threads that an event has occurred or that a task has been completed. The 
  8467.    waiting threads can then perform an action that is dependent on the 
  8468.    completion of the signaled event. 
  8469.  
  8470.  exception  An abnormal condition such as an I/O error encountered in 
  8471.    processing a data set or a file. 
  8472.  
  8473.  exclusive system semaphore  A system semaphore that can be modified only by 
  8474.    threads within the same process. 
  8475.  
  8476.  executable file  (1) A file that contains programs or commands that perform 
  8477.    operations or actions to be taken. (2) A collection of related data records 
  8478.    that execute programs. 
  8479.  
  8480.  exit  To execute an instruction within a portion of a computer program in 
  8481.    order to terminate the execution of that portion. Such portions of computer 
  8482.    programs include loops, subroutines, modules, and so on. (T)  Repeated exit 
  8483.    requests return the user to the point from which all functions provided to 
  8484.    the system are accessible. Contrast with cancel. 
  8485.  
  8486.  expanded memory specification (EMS)  Enables DOS applications to access memory 
  8487.    above the 1MB real mode addressing limit. 
  8488.  
  8489.  extended attribute  An additional piece of information about a file object, 
  8490.    such as its data format or category. It consists of a name and a value. A 
  8491.    file object may have more than one extended attribute associated with it. 
  8492.  
  8493.  extended help  In SAA Common User Access architecture, a help action that 
  8494.    provides information about the contents of the application window from which 
  8495.    a user requested help. Contrast with contextual help. 
  8496.  
  8497.  extended-choice selection  A mode that allows the user to select more than one 
  8498.    item from a window. Not all windows allow extended choice selection. 
  8499.    Contrast with multiple-choice selection. 
  8500.  
  8501.  extent  Continuous space on a disk or diskette that is occupied by or reserved 
  8502.    for a particular data set, data space, or file. 
  8503.  
  8504.  external link  In Information Presentation Facility, a link that connects 
  8505.    external online document files. 
  8506.  
  8507.  
  8508. ΓòÉΓòÉΓòÉ <hidden> Glossary - F ΓòÉΓòÉΓòÉ
  8509.  
  8510.  family-mode application  An application program that can run in the OS/2 
  8511.    environment and in the DOS environment; however, it cannot take advantage of 
  8512.    many of the OS/2-mode facilities, such as multitasking, interprocess 
  8513.    communication, and dynamic linking. 
  8514.  
  8515.  FAT  File allocation table. 
  8516.  
  8517.  FEA  Full extended attribute. 
  8518.  
  8519.  field-level help  Information specific to the field on which the cursor is 
  8520.    positioned. This help function is "contextual" because it provides 
  8521.    information about a specific item as it is currently used; the information 
  8522.    is dependent upon the context within the work session. 
  8523.  
  8524.  FIFO  First-in-first-out. (A)
  8525.  
  8526.  file  A named set of records stored or processed as a unit. (T)
  8527.  
  8528.  file allocation table (FAT)  In IBM personal computers, a table used by the 
  8529.    operating system to allocate space on a disk for a file, and to locate and 
  8530.    chain together parts of the file that may be scattered on different sectors 
  8531.    so that the file can be used in a random or sequential manner. 
  8532.  
  8533.  file attribute  Any of the attributes that describe the characteristics of a 
  8534.    file. 
  8535.  
  8536.  File Manager  In the Presentation Manager, a program that displays directories 
  8537.    and files, and allows various actions on them. 
  8538.  
  8539.  file specification  The full identifier for a file, which includes its drive 
  8540.    designation, path, file name, and extension. 
  8541.  
  8542.  file system  The combination of software and hardware that supports storing 
  8543.    information on a storage device. 
  8544.  
  8545.  file system driver (FSD)  A program that manages file I\O and controls the 
  8546.    format of information on the storage media. 
  8547.  
  8548.  fillet  A curve that is tangential to the end points of two adjoining lines. 
  8549.    See also polyfillet. 
  8550.  
  8551.  filtering  An application process that changes the order of data in a queue. 
  8552.  
  8553.  first-in-first-out (FIFO)  A queuing technique in which the next item to be 
  8554.    retrieved is the item that has been in the queue for the longest time. (A)
  8555.  
  8556.  flag  (1) An indicator or parameter that shows the setting of a switch. (2) A 
  8557.    character that signals the occurrence of some condition, such as the end of 
  8558.    a word. (A)  (3) (D of C) A characteristic of a file or directory that 
  8559.    enables it to be used in certain ways. See also archive flag, hidden flag, 
  8560.    and read-only flag. 
  8561.  
  8562.  focus  See input focus. 
  8563.  
  8564.  folder  A container used to organize objects. 
  8565.  
  8566.  font  A particular size and style of typeface that contains definitions of 
  8567.    character sets, marker sets, and pattern sets. 
  8568.  
  8569.  Font Editor  A utility program provided with the IBM Developers Toolkit that 
  8570.    enables the design and creation of new fonts. 
  8571.  
  8572.  foreground program  (1) The program with which the user is currently 
  8573.    interacting. Also known as interactive program. Contrast with background 
  8574.    program. (2) (D of C) In multiprogramming,  a high-priority program. 
  8575.  
  8576.  frame  The part of a window that can contain several different visual elements 
  8577.    specified by the application, but drawn and controlled by the Presentation 
  8578.    Manager. The frame encloses the client area. 
  8579.  
  8580.  frame styles  Standard window layouts provided by the Presentation Manager. 
  8581.  
  8582.  FSD  File system driver. 
  8583.  
  8584.  full-duplex  Synonym for duplex. 
  8585.  
  8586.  full-screen application  An application that has complete control of the 
  8587.    screen. 
  8588.  
  8589.  function  (1) In a programming language, a block, with or without formal 
  8590.    parameters, whose execution is invoked by means of a call. (2) A set of 
  8591.    related control statements that cause one or more programs to be performed. 
  8592.  
  8593.  function key  A key that causes a specified sequence of operations to be 
  8594.    performed when it is pressed, for example, F1 and Alt-K. 
  8595.  
  8596.  function key area  The area at the bottom of a window that contains function 
  8597.    key assignments such as F1=Help. 
  8598.  
  8599.  
  8600. ΓòÉΓòÉΓòÉ <hidden> Glossary - G ΓòÉΓòÉΓòÉ
  8601.  
  8602.  GDT  Global Descriptor Table. 
  8603.  
  8604.  general protection fault  An exception condition that occurs when a process 
  8605.    attempts to use storage or a module that has some level of protection 
  8606.    assigned to it, such as I/O privilege level. See also IOPL code segment. 
  8607.  
  8608.  Global Descriptor Table (GDT)  A table that defines code and data segments 
  8609.    available to all tasks in an application. 
  8610.  
  8611.  global dynamic-link module  A dynamic-link module that can be shared by all 
  8612.    processes in the system that refer to the module name. 
  8613.  
  8614.  global file-name character  Either a question mark (?) or an asterisk (*) used 
  8615.    as a variable in a file name or file name extension when referring to a 
  8616.    particular file or group of files. 
  8617.  
  8618.  glyph  A graphic symbol whose appearance conveys information. 
  8619.  
  8620.  GPI  Graphics programming interface. 
  8621.  
  8622.  graphic primitive  In computer graphics, a basic element, such as an arc or a 
  8623.    line, that is not made up of smaller parts and that is used to create 
  8624.    diagrams and pictures. See also graphics segment. 
  8625.  
  8626.  graphics  (1) A picture defined in terms of graphic primitives and graphics 
  8627.    attributes. (2) (D of C) The making of charts and pictures. (3) Pertaining 
  8628.    to charts, tables, and their creation. (4) See computer graphics, coordinate 
  8629.    graphics, fixed-image graphics, interactive graphics, passive graphics, 
  8630.    raster graphics. 
  8631.  
  8632.  graphics attributes  Attributes that apply to graphic primitives. Examples are 
  8633.    color, line type, and shading-pattern definition. See also segment 
  8634.    attributes. 
  8635.  
  8636.  graphics field  The clipping boundary that defines the visible part of the 
  8637.    presentation-page contents. 
  8638.  
  8639.  graphics mode  One of several states of a display. The mode determines the 
  8640.    resolution and color content of the screen. 
  8641.  
  8642.  graphics model space  The conceptual coordinate space in which a picture is 
  8643.    constructed after any model transforms have been applied. Also known as 
  8644.    model space. 
  8645.  
  8646.  Graphics programming interface  The formally defined programming language that 
  8647.    is between an IBM graphics program and the user of the program. 
  8648.  
  8649.  graphics segment  A sequence of related graphic primitives and graphics 
  8650.    attributes. See also graphic primitive. 
  8651.  
  8652.  graying  The indication that a choice on a pull-down is unavailable. 
  8653.  
  8654.  group  A collection of logically connected controls. For example, the buttons 
  8655.    controlling paper size for a printer could be called a group. See also 
  8656.    program group. 
  8657.  
  8658.  
  8659. ΓòÉΓòÉΓòÉ <hidden> Glossary - H ΓòÉΓòÉΓòÉ
  8660.  
  8661.  handle  (1) An identifier that represents an object, such as a device or 
  8662.    window, to the Presentation Interface. (2) (D of C) In the Advanced DOS and 
  8663.    OS/2 operating systems, a binary value created by the system that identifies 
  8664.    a drive, directory, and file so that the file can be found and opened. 
  8665.  
  8666.  hard error  An error condition on a network that requires either that the 
  8667.    system be reconfigured or that the source of the error be removed before the 
  8668.    system can resume reliable operation. 
  8669.  
  8670.  header  (1) System-defined control information that precedes user data. (2) 
  8671.    The portion of a message that contains control information for the message, 
  8672.    such as one or more destination fields, name of the originating station, 
  8673.    input sequence number, character string indicating the type of message, and 
  8674.    priority level for the message. 
  8675.  
  8676.  heading tags  A document element that enables information to be displayed in 
  8677.    windows, and that controls entries in the contents window controls placement 
  8678.    of push buttons in a window, and defines the shape and size of windows. 
  8679.  
  8680.  heap  An area of free storage available for dynamic allocation by an 
  8681.    application. Its size varies according to the storage requirements of the 
  8682.    application. 
  8683.  
  8684.  help function  (1) A function that provides information about a specific 
  8685.    field, an application panel, or information about the help facility. (2) (D 
  8686.    of C) One or more display images that describe how to use application 
  8687.    software or how to do a system operation. 
  8688.  
  8689.  Help index  In SAA Common User Access architecture, a help action that 
  8690.    provides an index of the help information available for an application. 
  8691.  
  8692.  help panel  A panel with information to assist users that is displayed in 
  8693.    response to a help request from the user. 
  8694.  
  8695.  help window  A Common-User-Access-defined secondary window that displays 
  8696.    information when the user requests help. 
  8697.  
  8698.  hidden file  An operating system file that is not displayed by a directory 
  8699.    listing. 
  8700.  
  8701.  hide button  In the OS/2 operating system, a small, square button located in 
  8702.    the right-hand corner of the title bar of a window that, when selected, 
  8703.    removes from the screen all the windows associated with that window. 
  8704.    Contrast with maximize button. See also restore button. 
  8705.  
  8706.  hierarchical inheritance  The relationship between parent and child classes. 
  8707.    An object that is lower in the inheritance hierarchy than another object, 
  8708.    inherits all the characteristics and behaviors of the objects above it in 
  8709.    the hierarchy. 
  8710.  
  8711.  hierarchy  A tree of segments beginning with the root segment and proceeding 
  8712.    downward to dependent segment types. 
  8713.  
  8714.  high-performance file system (HPFS)  In the OS/2 operating system, an 
  8715.    installable file system that uses high-speed buffer storage, known as a 
  8716.    cache, to provide fast access to large disk volumes. The file system also 
  8717.    supports the coexistence of multiple, active file systems on a single 
  8718.    personal computer, with the capability of multiple and different storage 
  8719.    devices. File names used with the HPFS can have as many as 254 characters. 
  8720.  
  8721.  hit testing  The means of identifying which window is associated with which 
  8722.    input device event. 
  8723.  
  8724.  hook  A point in a system-defined function where an application can supply 
  8725.    additional code that the system processes as though it were part of the 
  8726.    function. 
  8727.  
  8728.  hook chain  A sequence of hook procedures that are "chained" together so that 
  8729.    each event is passed, in turn, to each procedure in the chain. 
  8730.  
  8731.  hot spot  The part of the pointer that must touch an object before it can be 
  8732.    selected. This is usually the tip of the pointer. Contrast with action 
  8733.    point. 
  8734.  
  8735.  HPFS  high-performance file system. 
  8736.  
  8737.  hypergraphic link  A connection between one piece of information and another 
  8738.    through the use of graphics. 
  8739.  
  8740.  hypertext  A way of presenting information online with connections between one 
  8741.    piece of information and another, called hypertext links. See also hypertext 
  8742.    link. 
  8743.  
  8744.  hypertext link  A connection between one piece of information and another. 
  8745.  
  8746.  
  8747. ΓòÉΓòÉΓòÉ <hidden> Glossary - I ΓòÉΓòÉΓòÉ
  8748.  
  8749.  I/O operation  An input operation to, or output operation from a device 
  8750.    attached to a computer. 
  8751.  
  8752.  I-beam pointer  A pointer that indicates an area, such as an entry field in 
  8753.    which text can be edited. 
  8754.  
  8755.  icon  In SAA Advanced Common User Access architecture, a graphical 
  8756.    representation of an object, consisting of an image, image background, and a 
  8757.    label. Icons can represent items (such as a document file) that the user 
  8758.    wants to work on, and actions that the user wants to perform. In the 
  8759.    Presentation Manager, icons are used for data objects, system actions, and 
  8760.    minimized programs. 
  8761.  
  8762.  icon area  In the Presentation Manager, the area at the bottom of the screen 
  8763.    that is normally used to display the icons for minimized programs. 
  8764.  
  8765.  Icon Editor  The Presentation Manager-provided tool for creating icons. 
  8766.  
  8767.  IDL  Interface Definition Language. 
  8768.  
  8769.  image font  A set of symbols, each of which is described in a rectangular 
  8770.    array of pels. Some of the pels in the array are set to produce the image of 
  8771.    one of the symbols. Contrast with outline font. 
  8772.  
  8773.  implied metaclass  Subclassing the metaclass of a parent class without a 
  8774.    separate CSC for the resultant metaclass. 
  8775.  
  8776.  indirect manipulation  Interaction with an object through choices and 
  8777.    controls. 
  8778.  
  8779.  information device context  A logical description of a data destination other 
  8780.    than the screen (for example, a printer or plotter), but where no output 
  8781.    will occur. Its purpose is to satisfy queries. See also device context. 
  8782.  
  8783.  information panel  A defined panel type characterized by a body containing 
  8784.    only protected information. 
  8785.  
  8786.  Information Presentation Facility (IPF)  A facility provided by the OS/2 
  8787.    operating system, by which application developers can produce online 
  8788.    documentation and context-sensitive online help panels for their 
  8789.    applications. 
  8790.  
  8791.  inheritance  The derivation of new (child) classes from existing (parent) 
  8792.    classes. The new class inherits all the data and methods of the parent class 
  8793.    without having to redefine them. 
  8794.  
  8795.  input focus  (1) The area of a window where user interaction is possible using 
  8796.    an input device, such as a mouse or the keyboard. (2) The position in the 
  8797.    active window where a user's normal interaction with the keyboard will 
  8798.    appear. 
  8799.  
  8800.  input router  An internal OS/2 process that removes messages from the system 
  8801.    queue. 
  8802.  
  8803.  input/output control  A device-specific command that requests a function of a 
  8804.    device driver. 
  8805.  
  8806.  installable file system (IFS)  A file system in which software is installed 
  8807.    when the operating system is started. 
  8808.  
  8809.  instance  A single occurrence of an object class that has a particular 
  8810.    behavior. 
  8811.  
  8812.  instruction pointer  In system/38, a pointer that provides addressability for 
  8813.    a machine interface instruction in a program. 
  8814.  
  8815.  integer atom  An atom that represents a predefined system constant and carries 
  8816.    no storage overhead. For example, names of window classes provided by 
  8817.    Presentation Manager are expressed as integer atoms. 
  8818.  
  8819.  interactive graphics  Graphics that can be moved or manipulated by a user at a 
  8820.    terminal. 
  8821.  
  8822.  interactive program  (1) A program that is running (active) and is ready to 
  8823.    receive (or is receiving) input from a user. (2) A running program that can 
  8824.    receive input from the keyboard or another input device. Compare with active 
  8825.    program and contrast with noninteractive program. 
  8826.  
  8827.    Also known as a foreground program. 
  8828.  
  8829.  interchange file  A file containing data that can be sent from one 
  8830.    Presentation Manager interface application to another. 
  8831.  
  8832.  Interface Definition Language (IDL)  Language-neutral interface specification 
  8833.    for a SOM class. 
  8834.  
  8835.  interpreter  A program that translates and executes each instruction of a 
  8836.    high-level programming language before it translates and executes. 
  8837.  
  8838.  interprocess communication (IPC)  In the OS/2 operating system, the exchange 
  8839.    of information between processes or threads through semaphores, pipes, 
  8840.    queues, and shared memory. 
  8841.  
  8842.  interval timer  (1) A timer that provides program interruptions on a 
  8843.    program-controlled basis. (2) An electronic counter that counts intervals of 
  8844.    time under program control. 
  8845.  
  8846.  IOCtl  Input/output control. 
  8847.  
  8848.  IOPL  Input/output privilege level. 
  8849.  
  8850.  IOPL code segment  An IOPL executable section of programming code that enables 
  8851.    an application to directly manipulate hardware interrupts and ports without 
  8852.    replacing the device driver. See also privilege level. 
  8853.  
  8854.  IPC  Interprocess communication. 
  8855.  
  8856.  IPF  Information Presentation Facility. 
  8857.  
  8858.  IPF compiler  A text compiler that interpret tags in a source file and 
  8859.    converts the information into the specified format. 
  8860.  
  8861.  IPF tag language  A markup language that provides the instructions for 
  8862.    displaying online information. 
  8863.  
  8864.  item  A data object that can be passed in a DDE transaction. 
  8865.  
  8866.  
  8867. ΓòÉΓòÉΓòÉ <hidden> Glossary - J ΓòÉΓòÉΓòÉ
  8868.  
  8869.  journal  A special-purpose file that is used to record changes made in the 
  8870.    system. 
  8871.  
  8872.  
  8873. ΓòÉΓòÉΓòÉ <hidden> Glossary - K ΓòÉΓòÉΓòÉ
  8874.  
  8875.  Kanji  A graphic character set used in Japanese ideographic alphabets. 
  8876.  
  8877.  KBD$  Character-device name reserved for the keyboard. 
  8878.  
  8879.  kernel  The part of an operating system that performs basic functions, such as 
  8880.    allocating hardware resources. 
  8881.  
  8882.  kerning  The design of graphics characters so that their character boxes 
  8883.    overlap. Used to space text proportionally. 
  8884.  
  8885.  keyboard accelerator  A keystroke that generates a command message for an 
  8886.    application. 
  8887.  
  8888.  keyboard augmentation  A function that enables a user to press a keyboard key 
  8889.    while pressing a mouse button. 
  8890.  
  8891.  keyboard focus  A temporary attribute of a window. The window that has a 
  8892.    keyboard focus receives all keyboard input until the focus changes to a 
  8893.    different window. 
  8894.  
  8895.  Keys help  In SAA Common User Access architecture, a help action that provides 
  8896.    a listing of the application keys and their assigned functions. 
  8897.  
  8898.  
  8899. ΓòÉΓòÉΓòÉ <hidden> Glossary - L ΓòÉΓòÉΓòÉ
  8900.  
  8901.  label  In a graphics segment, an identifier of one or more elements that is 
  8902.    used when editing the segment. 
  8903.  
  8904.  LAN  local area network. 
  8905.  
  8906.  language support procedure  A function provided by the Presentation Manager 
  8907.    Interface for applications that do not, or cannot (as in the case of COBOL 
  8908.    and FORTRAN programs), provide their own dialog or window procedures. 
  8909.  
  8910.  lazy drag  See pickup and drop. 
  8911.  
  8912.  lazy drag set  See pickup set. 
  8913.  
  8914.  LDT  In the OS/2 operating system, Local Descriptor Table. 
  8915.  
  8916.  LIFO stack  A stack from which data is retrieved in last-in, first-out order. 
  8917.  
  8918.  linear address  A unique value that identifies the memory object. 
  8919.  
  8920.  linked list  Synonym for chained list. 
  8921.  
  8922.  list box  In SAA Advanced Common User Access architecture, a control that 
  8923.    contains scrollable choices from which a user can select one choice. 
  8924.  
  8925.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  8926.    selection list. 
  8927.  
  8928.  list button  A button labeled with an underlined down-arrow that presents a 
  8929.    list of valid objects or choices that can be selected for that field. 
  8930.  
  8931.  list panel  A defined panel type that displays a list of items from which 
  8932.    users can select one or more choices and then specify one or more actions to 
  8933.    work on those choices. 
  8934.  
  8935.  load time  The point in time at which a program module is loaded into main 
  8936.    storage for execution. 
  8937.  
  8938.  load-on-call  A function of a linkage editor that allows selected segments of 
  8939.    the module to be disk resident while other segments are executing. Disk 
  8940.    resident segments are loaded for execution and given control when any entry 
  8941.    point that they contain is called. 
  8942.  
  8943.  local area network (LAN)  (1) A computer network located on a user's premises 
  8944.    within a limited geographical area. Communication within a local area 
  8945.    network is not subject to external regulations;  however, communication 
  8946.    across the LAN boundary may be subject to some form of regulation. (T)
  8947.  
  8948.    Note:  A LAN does not use store and forward techniques. (2) A network 
  8949.    inwhich a set of devices are connected to one another for communication and 
  8950.    that can be connected to a larger network. 
  8951.  
  8952.  Local Descriptor Table (LDT)  Defines code and data segments specific to a 
  8953.    single task. 
  8954.  
  8955.  lock  A serialization mechanism by means of which a resource is restricted for 
  8956.    use by the holder of the lock. 
  8957.  
  8958.  logical storage device  A device that the user can map to a physical (actual) 
  8959.    device. 
  8960.  
  8961.  LPT1, LPT2, LPT3  Character-device names reserved for parallel printers 1 
  8962.    through 3. 
  8963.  
  8964.  
  8965. ΓòÉΓòÉΓòÉ <hidden> Glossary - M ΓòÉΓòÉΓòÉ
  8966.  
  8967.  main window  The window that is positioned relative to the desktop window. 
  8968.  
  8969.  manipulation button  The button on a pointing device a user presses to 
  8970.    directly manipulate an object. 
  8971.  
  8972.  map  (1) A set of values having a defined correspondence with the quantities 
  8973.    or values of another set. (I)  (A)  (2) To establish a set of values having 
  8974.    a defined correspondence with the quantities or values of another set. (I)
  8975.  
  8976.  marker box  In computer graphics, the boundary that defines, in world 
  8977.    coordinates, the horizontal and vertical space occupied by a single marker 
  8978.    from a marker set. 
  8979.  
  8980.  marker symbol  A symbol centered on a point. Graphs and charts can use marker 
  8981.    symbols to indicate the plotted points. 
  8982.  
  8983.  marquee box  The rectangle that appears during a selection technique in which 
  8984.    a user selects objects by drawing a box around them with a pointing device. 
  8985.  
  8986.  Master Help Index  In the OS/2 operating system, an alphabetic list of help 
  8987.    topics related to using the operating system. 
  8988.  
  8989.  maximize  To enlarge a window to its largest possible size. 
  8990.  
  8991.  media window  The part of the physical device (display, printer, or plotter) 
  8992.    on which a picture is presented. 
  8993.  
  8994.  memory block  Part memory within a heap. 
  8995.  
  8996.  memory device context  A logical description of a data destination that is a 
  8997.    memory bit map. See also device context. 
  8998.  
  8999.  memory management  A feature of the operating system for allocating, sharing, 
  9000.    and freeing main storage. 
  9001.  
  9002.  memory object  Logical unit of memory requested by an application, which forms 
  9003.    the granular unit of memory manipulation from the application viewpoint. 
  9004.  
  9005.  menu  In SAA Advanced Common User Access architecture, an extension of the 
  9006.    menu bar that displays a list of choices available for a selected choice in 
  9007.    the menu bar. After a user selects a choice in menu bar, the corresponding 
  9008.    menu appears. Additional pop-up windows can appear from menu choices. 
  9009.  
  9010.  menu bar  In SAA Advanced Common User Access architecture, the area near the 
  9011.    top of a window, below the title bar and above the rest of the window, that 
  9012.    contains choices that provide access to other menus. 
  9013.  
  9014.  menu button  The button on a pointing device that a user presses to view a 
  9015.    pop-up menu associated with an object. 
  9016.  
  9017.  message  (1) In the Presentation Manager, a packet of data used for 
  9018.    communication between the Presentation Manager interface and Presentation 
  9019.    Manager applications (2) In a user interface, information not requested by 
  9020.    users but presented to users by the computer in response to a user action or 
  9021.    internal process. 
  9022.  
  9023.  message box  (1) A dialog window predefined by the system and used as a simple 
  9024.    interface for applications, without the necessity of creating 
  9025.    dialog-template resources or dialog procedures. (2) (D of C) In SAA Advanced 
  9026.    Common User Access architecture, a type of window that shows messages to 
  9027.    users. See also dialog box, primary window, secondary window. 
  9028.  
  9029.  message filter  The means of selecting which messages from a specific window 
  9030.    will be handled by the application. 
  9031.  
  9032.  message queue  A sequenced collection of messages to be read by the 
  9033.    application. 
  9034.  
  9035.  message stream mode  A method of operation in which data is treated as a 
  9036.    stream of messages.  Contrast with  byte stream. 
  9037.  
  9038.  metacharacter  See global file-name character. 
  9039.  
  9040.  metaclass  The conjunction of an object and its class information; that is, 
  9041.    the information pertaining to the class as a whole, rather than to a single 
  9042.    instance of the class. Each class is itself an object, which is an instance 
  9043.    of the metaclass. 
  9044.  
  9045.  metafile  A file containing a series of attributes that set color, shape and 
  9046.    size, usually of a picture or a drawing. Using a program that can interpret 
  9047.    these attributes, a user can view the assembled image. 
  9048.  
  9049.  metafile device context  A logical description of a data destination that is a 
  9050.    metafile, which is used for graphics interchange. See also device context. 
  9051.  
  9052.  metalanguage  A language used to specify another language. For example, data 
  9053.    types can be described using a metalanguage so as to make the descriptions 
  9054.    independent of any one computer language. 
  9055.  
  9056.  method  A function that defines a behavior for a class or object. 
  9057.  
  9058.  method override  The replacement, by a child class, of the implementation of a 
  9059.    method inherited from a parent and an ancestor class. 
  9060.  
  9061.  mickey  A unit of measurement for physical mouse motion whose value depends on 
  9062.    the mouse device driver currently loaded. 
  9063.  
  9064.  micro presentation space  A graphics presentation space in which a restricted 
  9065.    set of the GPI function calls is available. 
  9066.  
  9067.  minimize  To remove from the screen all windows associated with an application 
  9068.    and replace them with an icon that represents the application. 
  9069.  
  9070.  mix  An attribute that determines how the foreground of a graphic primitive is 
  9071.    combined with the existing color of graphics output. Also known as 
  9072.    foreground mix. Contrast with background mix. 
  9073.  
  9074.  mixed character string  A string containing a mixture of one-byte and Kanji or 
  9075.    Hangeul (two-byte) characters. 
  9076.  
  9077.  mnemonic  (1) A method of selecting an item on a pull-down by means of typing 
  9078.    the highlighted letter in the menu item. (2) (D of C) In SAA Advanced Common 
  9079.    User Access architecture, usually a single character, within the text of a 
  9080.    choice, identified by an underscore beneath the character. If all characters 
  9081.    in a choice already serve as mnemonics for other choices, another character, 
  9082.    placed in parentheses immediately following the choice, can be used. When a 
  9083.    user types the mnemonic for a choice, the choice is either selected or the 
  9084.    cursor is moved to that choice. 
  9085.  
  9086.  modal dialog box  In SAA Advanced Common User Access architecture, a type of 
  9087.    movable window, fixed in size, that requires a user to enter information 
  9088.    before continuing to work in the application window from which it was 
  9089.    displayed. Contrast with modeless dialog box. Also known as a serial dialog 
  9090.    box. Contrast with parallel dialog box. 
  9091.  
  9092.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  9093.    pop-up window. 
  9094.  
  9095.  model space  See graphics model space. 
  9096.  
  9097.  modeless dialog box  In SAA Advanced Common User Access architecture, a type 
  9098.    of movable window, fixed in size, that allows users to continue their dialog 
  9099.    with the application without entering information in the dialog box. Also 
  9100.    known as a parallel dialog box. Contrast with modal dialog box. 
  9101.  
  9102.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  9103.    pop-up window. 
  9104.  
  9105.  module definition file  A file that describes the code segments within a load 
  9106.    module. For example, it indicates whether a code segment is loadable before 
  9107.    module execution begins (preload), or loadable only when referred to at run 
  9108.    time (load-on-call). 
  9109.  
  9110.  mouse  In SAA usage, a device that a user moves on a flat surface to position 
  9111.    a pointer on the screen. It allows a user to select a choice o function to 
  9112.    be performed or to perform operations on the screen, such as dragging or 
  9113.    drawing lines from one position to another. 
  9114.  
  9115.  MOUSE$  Character-device name reserved for a mouse. 
  9116.  
  9117.  multiple-choice selection  In SAA Basic Common User Access architecture, a 
  9118.    type of field from which a user can select one or more choices or select 
  9119.    none. See also check box. Contrast with extended-choice selection. 
  9120.  
  9121.  multiple-line entry field  In SAA Advanced Common User Access architecture, a 
  9122.    control into which a user types more than one line of information. See also 
  9123.    single-line entry field. 
  9124.  
  9125.  multitasking  The concurrent processing of applications or parts of 
  9126.    applications. A running application and its data are protected from other 
  9127.    concurrently running applications. 
  9128.  
  9129.  mutex semaphore  (Mutual exclusion semaphore). A semaphore that enables 
  9130.    threads to serialize their access to resources. Only the thread that 
  9131.    currently owns the mutex semaphore can gain access to the resource, thus 
  9132.    preventing one thread from interrupting operations being performed by 
  9133.    another. 
  9134.  
  9135.  muxwait semaphore  (Multiple wait semaphore). A semaphore that enables a 
  9136.    thread to wait either for multiple event semaphores to be posted or for 
  9137.    multiple mutex semaphores to be released. Alternatively, a muxwait semaphore 
  9138.    can be set to enable a thread to wait for any ONE of the event or mutex 
  9139.    semaphores in the muxwait semaphore's list to be posted or released. 
  9140.  
  9141.  
  9142. ΓòÉΓòÉΓòÉ <hidden> Glossary - N ΓòÉΓòÉΓòÉ
  9143.  
  9144.  named pipe  A named buffer that provides client-to-server, server-to-client, 
  9145.    or full duplex communication between unrelated processes. Contrast with 
  9146.    unnamed pipe. 
  9147.  
  9148.  national language support (NLS)  The modification or conversion of a United 
  9149.    States English product to conform to the requirements of another language or 
  9150.    country. This can include the enabling or retrofitting of a product and the 
  9151.    translation of nomenclature, MRI, or documentation of a product. 
  9152.  
  9153.  nested list  A list that is contained within another list. 
  9154.  
  9155.  NLS  national language support. 
  9156.  
  9157.  non-8.3 file-name format  A file-naming convention in which file names can 
  9158.    consist of up to 255 characters. See also 8.3 file-name format. 
  9159.  
  9160.  noncritical extended attribute  An extended attribute that is not necessary 
  9161.    for the function of an application. 
  9162.  
  9163.  nondestructive read  Reading that does not erase the data in the source 
  9164.    location. (T)
  9165.  
  9166.  noninteractive program  A running program that cannot receive input from the 
  9167.    keyboard or other input device. Compare with active program, and contrast 
  9168.    with interactive program. 
  9169.  
  9170.  nonretained graphics  Graphic primitives that are not remembered by the 
  9171.    Presentation Manager interface when they have been drawn. Contrast with 
  9172.    retained graphics. 
  9173.  
  9174.  null character (NUL)  (1) Character-device name reserved for a nonexistent 
  9175.    (dummy) device. (2) (D of C) A control character that is used to accomplish 
  9176.    media-fill or time-fill and that may be inserted into or removed from a 
  9177.    sequence of characters without affecting the meaning of the sequence; 
  9178.    however, the control of equipment or the format may be affected by this 
  9179.    character. (I)  (A)
  9180.  
  9181.  null-terminated string  A string of (n+1) characters where the (n+1)th 
  9182.    character is the `null' character (0x00) Also known as `zero-terminated' 
  9183.    string and 'ASCIIZ' string. 
  9184.  
  9185.  
  9186. ΓòÉΓòÉΓòÉ <hidden> Glossary - O ΓòÉΓòÉΓòÉ
  9187.  
  9188.  object  A set of data and actions that can be performed on that data. 
  9189.  
  9190.  Object Interface Definition Language (OIDL)  Specification language used in 
  9191.    SOM Version 1 for defining classes. Replaced by Interface Definition 
  9192.    Language (IDL). 
  9193.  
  9194.  object window  A window that does not have a parent but which might have child 
  9195.    windows. An object window cannot be presented on a device. 
  9196.  
  9197.  OIDL  Object Interface Definition Language. 
  9198.  
  9199.  open  To start working with a file, directory, or other object. 
  9200.  
  9201.  ordered list  Vertical arrangements of items, with each item in the list 
  9202.    preceded by a number or letter. 
  9203.  
  9204.  outline font  A set of symbols, each of which is created as a series of lines 
  9205.    and curves.  Synonymous with vector font. Contrast with image font. 
  9206.  
  9207.  output area  An area of storage reserved for output. (A)
  9208.  
  9209.  owner window  A window into which specific events that occur in another 
  9210.    (owned) window are reported. 
  9211.  
  9212.  ownership  The determination of how windows communicate using messages. 
  9213.  
  9214.  owning process  The process that owns the resources that might be shared with 
  9215.    other processes. 
  9216.  
  9217.  
  9218. ΓòÉΓòÉΓòÉ <hidden> Glossary - P ΓòÉΓòÉΓòÉ
  9219.  
  9220.  page  (1) A 4KB segment of contiguous physical memory. (2) (D of C) A defined 
  9221.    unit of space on a storage medium. 
  9222.  
  9223.  page viewport  A boundary in device coordinates that defines the area of the 
  9224.    output device in which graphics are to be displayed. The presentation-page 
  9225.    contents are transformed automatically to the page viewport in device space. 
  9226.  
  9227.  paint  (1) The action of drawing or redrawing the contents of a window. (2) In 
  9228.    computer graphics, to shade an area of a display image;  for example, with 
  9229.    crosshatching or color. 
  9230.  
  9231.  panel  In SAA Basic Common User Access architecture, a particular arrangement 
  9232.    of information that is presented in a window or pop-up. If some of the 
  9233.    information is not visible, a user can scroll through the information. 
  9234.  
  9235.  panel area  An area within a panel that contains related information. The 
  9236.    three major Common User Access-defined panel areas are the action bar, the 
  9237.    function key area, and the panel body. 
  9238.  
  9239.  panel area separator  In SAA Basic Common User Access architecture, a solid, 
  9240.    dashed, or blank line that provides a visual distinction between two 
  9241.    adjacent areas of a panel. 
  9242.  
  9243.  panel body  The portion of a panel not occupied by the action bar, function 
  9244.    key area, title or scroll bars. The panel body can contain protected 
  9245.    information, selection fields, and entry fields. The layout and content of 
  9246.    the panel body determine the panel type. 
  9247.  
  9248.  panel body area  See client area. 
  9249.  
  9250.  panel definition  A description of the contents and characteristics of a 
  9251.    panel. A panel definition is the application developer's mechanism for 
  9252.    predefining the format to be presented to users in a window. 
  9253.  
  9254.  panel ID  In SAA Basic Common User Access architecture, a panel identifier, 
  9255.    located in the upper-left corner of a panel.  A user can choose whether to 
  9256.    display the panel ID. 
  9257.  
  9258.  panel title  In SAA Basic Common User Access architecture, a particular 
  9259.    arrangement of information that is presented in a window or pop-up. If some 
  9260.    of the information is not visible, a user can scroll through the 
  9261.    information. 
  9262.  
  9263.  paper size  The size of paper, defined in either standard U.S. or European 
  9264.    names (for example, A, B, A4), and measured in inches or millimeters 
  9265.    respectively. 
  9266.  
  9267.  parallel dialog box  See modeless dialog box. 
  9268.  
  9269.  parameter list  A list of values that provides a means of associating 
  9270.    addressability of data defined in a called program with data in the calling 
  9271.    program. It contains parameter names and the order in which they are to be 
  9272.    associated in the calling and called program. 
  9273.  
  9274.  parent process  In the OS/2 operating system, a process that creates other 
  9275.    processes. Contrast with child process. 
  9276.  
  9277.  parent window  In the OS/2 operating system, a window that creates a child 
  9278.    window. The child window is drawn within the parent window. If the parent 
  9279.    window is moved, resized, or destroyed, the child window also will be moved, 
  9280.    resized, or destroyed. However, the child window can be moved and resized 
  9281.    independently from the parent window, within the boundaries of the parent 
  9282.    window. Contrast with child window. 
  9283.  
  9284.  partition  (1) A fixed-size division of storage. (2) On an IBM personal 
  9285.    computer fixed disk, one of four possible storage areas of variable size; 
  9286.    one may be accessed by DOS, and each of the others may be assigned to 
  9287.    another operating system. 
  9288.  
  9289.  Paste  A choice in the Edit pull-down that a user selects to move the contents 
  9290.    of the clipboard into a preselected location. See also Copy and Cut. 
  9291.  
  9292.  path  The route used to locate files; the storage location of a file. A fully 
  9293.    qualified path lists the drive identifier, directory name, subdirectory name 
  9294.    (if any), and file name with the associated extension. 
  9295.  
  9296.  PDD  Physical device driver. 
  9297.  
  9298.  peeking  An action taken by any thread in the process that owns the queue to 
  9299.    examine queue elements without removing them. 
  9300.  
  9301.  pel  (1) The smallest area of a display screen capable of being addressed and 
  9302.    switched between visible and invisible states. Synonym for display point, 
  9303.    pixel, and picture element. (2) (D of C) Picture element. 
  9304.  
  9305.  persistent object  An object whose instance data and state are preserved 
  9306.    between system shutdown and system startup. 
  9307.  
  9308.  physical device driver (PDD)  A system interface that handles hardware 
  9309.    interrupts and supports a set of input and output functions. 
  9310.  
  9311.  pick  To select part of a displayed object using the pointer. 
  9312.  
  9313.  pickup  To add an object or set of objects to the pickup set. 
  9314.  
  9315.  pickup and drop  A drag operation that does not require the direct 
  9316.    manipulation button to be pressed for the duration of the drag. 
  9317.  
  9318.  pickup set  The set of objects that have been picked up as part of a pickup 
  9319.    and drop operation. 
  9320.  
  9321.  picture chain  See segment chain. 
  9322.  
  9323.  picture element  (1) Synonym for pel. (2) (D of C) In computer graphics, the 
  9324.    smallest element of a display surface that can be independently assigned 
  9325.    color and intensity. (T)  . (3) The area of the finest detail that can be 
  9326.    reproduced effectively on the recording medium. 
  9327.  
  9328.  PID  Process identification. 
  9329.  
  9330.  pipe  (1) A named or unnamed buffer used to pass data between processes. A 
  9331.    process reads from or writes to a pipe as if the pipe were a standard-input 
  9332.    or standard-output file. See also named pipe and unnamed pipe. (2) (D of C) 
  9333.    To direct data so that the output from one process becomes the input to 
  9334.    another process. The standard output of one command can be connected to the 
  9335.    standard input of another with the pipe operator (|). 
  9336.  
  9337.  pixel  (1) Synonym for pel. (2) (D of C) Picture element. 
  9338.  
  9339.  plotter  An output unit that directly produces a hardcopy record of data on a 
  9340.    removable medium, in the form of a two-dimensional graphic representation. (T)
  9341.  
  9342.  PM  Presentation Manager. 
  9343.  
  9344.  pointer  (1) The symbol displayed on the screen that is moved by a pointing 
  9345.    device, such as a mouse. The pointer is used to point at items that users 
  9346.    can select. Contrast with cursor. (2) A data element that indicates the 
  9347.    location of another data element. (T)
  9348.  
  9349.  POINTER$  Character-device name reserved for a pointer device (mouse screen 
  9350.    support). 
  9351.  
  9352.  pointing device  In SAA Advanced Common User Access architecture, an 
  9353.    instrument, such as a mouse, trackball, or joystick, used to move a pointer 
  9354.    on the screen. 
  9355.  
  9356.  pointings  Pairs of x-y coordinates produced by an operator defining positions 
  9357.    on a screen with a pointing device, such as a mouse. 
  9358.  
  9359.  polyfillet  A curve based on a sequence of lines. The curve is tangential to 
  9360.    the end points of the first and last lines, and tangential also to the 
  9361.    midpoints of all other lines. See also fillet. 
  9362.  
  9363.  polygon  One or more closed figures that can be drawn filled, outlined, or 
  9364.    filled and outlined. 
  9365.  
  9366.  polyline  A sequence of adjoining lines. 
  9367.  
  9368.  polymorphism  The ability to have different implementations of the same method 
  9369.    for two or more classes of objects. 
  9370.  
  9371.  pop  To retrieve an item from a last-in-first-out stack of items. Contrast 
  9372.    with push. 
  9373.  
  9374.  pop-up menu  A menu that lists the actions that a user can perform on an 
  9375.    object. The contents of the pop-up menu can vary depending on the context, 
  9376.    or state, of the object. 
  9377.  
  9378.  pop-up window  (1) A window that appears on top of another window in a dialog. 
  9379.    Each pop-up window must be completed before returning to the underlying 
  9380.    window. (2) (D of C) In SAA Advanced Common User Access architecture, a 
  9381.    movable window, fixed in size, in which a user provides information required 
  9382.    by an application so that it can continue to process a user request. 
  9383.  
  9384.  presentation drivers  Special purpose I/O routines that handle field 
  9385.    device-independent I/O requests from the PM and its applications. 
  9386.  
  9387.  Presentation Manager (PM)  The interface of the OS/2 operating system that 
  9388.    presents, in windows a graphics-based interface to applications and files 
  9389.    installed and running under the OS/2 operating system. 
  9390.  
  9391.  presentation page  The coordinate space in which a picture is assembled for 
  9392.    display. 
  9393.  
  9394.  presentation space (PS)  (1) Contains the device-independent definition of a 
  9395.    picture. (2) (D of C) The display space on a display device. 
  9396.  
  9397.  primary window  In SAA Common User Access architecture, the window in which 
  9398.    the main interaction between the user and the application takes place. In a 
  9399.    multiprogramming environment, each application starts in its own primary 
  9400.    window. The primary window remains for the duration of the application, 
  9401.    although the panel displayed will change as the user's dialog moves forward. 
  9402.    See also secondary window. 
  9403.  
  9404.  primitive  In computer graphics, one of several simple functions for drawing 
  9405.    on the screen, including, for example, the rectangle, line, ellipse, 
  9406.    polygon, and so on. 
  9407.  
  9408.  primitive attribute  A specifiable characteristic of a graphic primitive. See 
  9409.    graphics attributes. 
  9410.  
  9411.  print job  The result of sending a document or picture to be printed. 
  9412.  
  9413.  Print Manager  In the Presentation Manager, the part of the spooler that 
  9414.    manages the spooling process. It also allows users to view print queues and 
  9415.    to manipulate print jobs. 
  9416.  
  9417.  privilege level  A protection level imposed by the hardware architecture of 
  9418.    the IBM personal computer.  There are four privilege levels (number 0 
  9419.    through 3).  Only certain types of programs are allowed to execute at each 
  9420.    privilege level.  See also IOPL code segment. 
  9421.  
  9422.  procedure call  In programming languages, a language construct for invoking 
  9423.    execution of a procedure. 
  9424.  
  9425.  process  An instance of an executing application and the resources it is 
  9426.    using. 
  9427.  
  9428.  program  A sequence of instructions that a computer can interpret and execute. 
  9429.  
  9430.  program details  Information about a program that is specified in the Program 
  9431.    Manager window and is used when the program is started. 
  9432.  
  9433.  program group  In the Presentation Manager, several programs that can be acted 
  9434.    upon as a single entity. 
  9435.  
  9436.  program name  The full file specification of a program. Contrast with program 
  9437.    title. 
  9438.  
  9439.  program title  The name of a program as it is listed in the Program Manager 
  9440.    window. Contrast with program name. 
  9441.  
  9442.  prompt  A displayed symbol or message that requests input from the user or 
  9443.    gives operational information; for example, on the display screen of an IBM 
  9444.    personal computer, the DOS A> prompt. The user must respond to the prompt in 
  9445.    order to proceed. 
  9446.  
  9447.  protect mode  A method of program operation that limits or prevents access to 
  9448.    certain instructions or areas of storage. Contrast with real mode. 
  9449.  
  9450.  protocol  A set of semantic and syntactic rules that determines the behavior 
  9451.    of functional units in achieving communication. (I)
  9452.  
  9453.  pseudocode  An artificial language used to describe computer program 
  9454.    algorithms without using the syntax of any particular programming language. (A)
  9455.  
  9456.  pull-down  (1) An action bar extension that displays a list of choices 
  9457.    available for a selected action bar choice. After users select an action bar 
  9458.    choice, the pull-down appears with the list of choices. Additional pop-up 
  9459.    windows may appear from pull-down choices to further extend the actions 
  9460.    available to users. (2) (D of C) In SAA Common User Access architecture, 
  9461.    pertaining to a choice in an action bar pull-down. 
  9462.  
  9463.  push  To add an item to a last-in-first-out stack of items. Contrast with pop. 
  9464.  
  9465.  push button  In SAA Advanced Common User Access architecture, a rectangle with 
  9466.    text inside. Push buttons are used in windows for actions that occur 
  9467.    immediately when the push button is selected. 
  9468.  
  9469.  putback  To remove an object or set of objects from the lazy drag set. This 
  9470.    has the effect of undoing the pickup operation for those objects 
  9471.  
  9472.  putdown  To drop the objects in the lazy drag set on the target object. 
  9473.  
  9474.  
  9475. ΓòÉΓòÉΓòÉ <hidden> Glossary - Q ΓòÉΓòÉΓòÉ
  9476.  
  9477.  queue  (1) A linked list of elements waiting to be processed in FIFO order. 
  9478.    For example, a queue may be a list of print jobs waiting to be printed. (2) 
  9479.    (D of C) A line or list of items waiting to be processed; for example, work 
  9480.    to be performed or messages to be displayed. 
  9481.  
  9482.  queued device context  A logical description of a data destination (for 
  9483.    example, a printer or plotter) where the output is to go through the 
  9484.    spooler. See also device context. 
  9485.  
  9486.  
  9487. ΓòÉΓòÉΓòÉ <hidden> Glossary - R ΓòÉΓòÉΓòÉ
  9488.  
  9489.  radio button  (1) A control window, shaped like a round button on the screen, 
  9490.    that can be in a checked or unchecked state. It is used to select a single 
  9491.    item from a list. Contrast with check box. (2) In SAA Advanced Common User 
  9492.    Access architecture, a circle with text beside it. Radio buttons are 
  9493.    combined to show a user a fixed set of choices from which only one can be 
  9494.    selected. The circle is partially filled when a choice is selected. 
  9495.  
  9496.  RAS  Reliability, availability, and serviceability. 
  9497.  
  9498.  raster  (1) In computer graphics, a predetermined pattern of lines that 
  9499.    provides uniform coverage of a display space. (T)  (2) The coordinate grid 
  9500.    that divides the display area of a display device.  (A)
  9501.  
  9502.  read-only file  A file that can be read from but not written to. 
  9503.  
  9504.  real mode  A method of program operation that does not limit or prevent access 
  9505.    to any instructions or areas of storage.  The operating system loads the 
  9506.    entire program into storage and gives the program access to all system 
  9507.    resources. Contrast with protect mode. 
  9508.  
  9509.  realize  To cause the system to ensure, wherever possible, that the physical 
  9510.    color table of a device is set to the closest possible match in the logical 
  9511.    color table. 
  9512.  
  9513.  recursive routine  A routine that can call itself, or be called by another 
  9514.    routine that was called by the recursive routine. 
  9515.  
  9516.  reentrant  The attribute of a program or routine that allows the same copy of 
  9517.    the program or routine to be used concurrently by two or more tasks. 
  9518.  
  9519.  reference phrase  (1) A word or phrase that is emphasized in a 
  9520.    device-dependent manner to inform the user that additional information for 
  9521.    the word or phrase is available. (2) (D of C) In hypertext, text that is 
  9522.    highlighted and preceded by a single-character input field used to signify 
  9523.    the existence of a hypertext link. 
  9524.  
  9525.  reference phrase help  In SAA Common User Access architecture, highlighted 
  9526.    words or phrases within help information that a user selects to get 
  9527.    additional information. 
  9528.  
  9529.  refresh  To update a window, with changed information, to its current status. 
  9530.  
  9531.  region  A clipping boundary in device space. 
  9532.  
  9533.  register  A part of internal storage having a specified storage capacity and 
  9534.    usually intended for a specific purpose. (T)
  9535.  
  9536.  remote file system  A file-system driver that gains access to a remote system 
  9537.    without a block device driver. 
  9538.  
  9539.  resource  The means of providing extra information used in the definition of a 
  9540.    window. A resource can contain definitions of fonts, templates, 
  9541.    accelerators, and mnemonics; the definitions are held in a resource file. 
  9542.  
  9543.  resource file  A file containing information used in the definition of a 
  9544.    window. Definitions can be of fonts, templates, accelerators, and mnemonics. 
  9545.  
  9546.  restore  To return a window to its original size or position following a 
  9547.    sizing or moving action. 
  9548.  
  9549.  retained graphics  Graphic primitives that are remembered by the Presentation 
  9550.    Manager interface after they have been drawn. Contrast with nonretained 
  9551.    graphics. 
  9552.  
  9553.  return code  (1) A value returned to a program to indicate the results of an 
  9554.    operation requested by that program. (2) A code used to influence the 
  9555.    execution of succeeding instructions.(A) 
  9556.  
  9557.  reverse video  (1) A form of highlighting a character, field, or cursor by 
  9558.    reversing the color of the character, field, or cursor with its background; 
  9559.    for example, changing a red character on a black background to a black 
  9560.    character on a red background. (2) In SAA Basic Common User Access 
  9561.    architecture, a screen emphasis feature that interchanges the foreground and 
  9562.    background colors of an item. 
  9563.  
  9564.  REXX Language  Restructured Extended Executor. A procedural language that 
  9565.    provides batch language functions along with structured programming 
  9566.    constructs such as loops; conditional testing and subroutines. 
  9567.  
  9568.  RGB  (1) Color coding in which the brightness of the additive primary colors 
  9569.    of light, red, green, and blue, are specified as three distinct values of 
  9570.    white light. (2) Pertaining to a color display that accepts signals 
  9571.    representing red, green, and blue. 
  9572.  
  9573.  roman  Relating to a type style with upright characters. 
  9574.  
  9575.  root segment  In a hierarchical database, the highest segment in the tree 
  9576.    structure. 
  9577.  
  9578.  round-robin scheduling  A process that allows each thread to run for a 
  9579.    specified amount of time. 
  9580.  
  9581.  run time  (1) Any instant at which the execution of a particular computer 
  9582.    program takes place. (T)  (2) The amount of time needed for the execution of 
  9583.    a particular computer program. (T)  (3) The time during which an instruction 
  9584.    in an instruction register is decoded and performed. Synonym for execution 
  9585.    time. 
  9586.  
  9587.  
  9588. ΓòÉΓòÉΓòÉ <hidden> Glossary - S ΓòÉΓòÉΓòÉ
  9589.  
  9590.  SAA  Systems Application Architecture. 
  9591.  
  9592.  SBCS  Single-byte character set. 
  9593.  
  9594.  scheduler  A computer program designed to perform functions such as 
  9595.    scheduling, initiation, and termination of jobs. 
  9596.  
  9597.  screen  In SAA Basic Common User Access architecture, the physical surface of 
  9598.    a display device upon which information is shown to a user. 
  9599.  
  9600.  screen device context  A logical description of a data destination that is a 
  9601.    particular window on the screen. See also device context. 
  9602.  
  9603.  SCREEN$  Character-device name reserved for the display screen. 
  9604.  
  9605.  scroll bar  In SAA Advanced Common User Access architecture, a part of a 
  9606.    window, associated with a scrollable area, that a user interacts with to see 
  9607.    information that is not currently allows visible. 
  9608.  
  9609.  scrollable entry field  An entry field larger than the visible field. 
  9610.  
  9611.  scrollable selection field  A selection field that contains more choices than 
  9612.    are visible. 
  9613.  
  9614.  scrolling  Moving a display image vertically or horizontally in a manner such 
  9615.    that new data appears at one edge, as existing data disappears at the 
  9616.    opposite edge. 
  9617.  
  9618.  secondary window  A window that contains information that is dependent on 
  9619.    information in a primary window and is used to supplement the interaction in 
  9620.    the primary window. 
  9621.  
  9622.  sector  On disk or diskette storage, an addressable subdivision of a track 
  9623.    used to record one block of a program or data. 
  9624.  
  9625.  segment  See graphics segment. 
  9626.  
  9627.  segment attributes  Attributes that apply to the segment as an entity, as 
  9628.    opposed to the individual primitives within the segment. For example, the 
  9629.    visibility or detectability of a segment. 
  9630.  
  9631.  segment chain  All segments in a graphics presentation space that are defined 
  9632.    with the `chained' attribute. Synonym for picture chain. 
  9633.  
  9634.  segment priority  The order in which segments are drawn. 
  9635.  
  9636.  segment store  An area in a normal graphics presentation space where retained 
  9637.    graphics segments are stored. 
  9638.  
  9639.  select  To mark or choose an item. Note that select means to mark or type in a 
  9640.    choice on the screen; enter means to send all selected choices to the 
  9641.    computer for processing. 
  9642.  
  9643.  select button  The button on a pointing device, such as a mouse, that is 
  9644.    pressed to select a menu choice.  Also known as button 1. 
  9645.  
  9646.  selection cursor  In SAA Advanced Common User Access architecture, a visual 
  9647.    indication that a user has selected a choice. It is represented by outlining 
  9648.    the choice with a dotted box. See also text cursor. 
  9649.  
  9650.  selection field  (1) In SAA Advanced Common User Access architecture, a set of 
  9651.    related choices. See also entry field. (2) In SAA Basic Common User Access 
  9652.    architecture, an area of a panel that cannot be scrolled and contains a 
  9653.    fixed number of choices. 
  9654.  
  9655.  semantics  The relationships between symbols and their meanings. 
  9656.  
  9657.  semaphore  An object used by applications for signalling purposes and for 
  9658.    controlling access to serially reusable resources. 
  9659.  
  9660.  separator  In SAA Advanced Common User Access architecture, a line or color 
  9661.    boundary that provides a visual distinction between two adjacent areas. 
  9662.  
  9663.  serial dialog box  See modal dialog box. 
  9664.  
  9665.  serialization  The consecutive ordering of items. 
  9666.  
  9667.  serialize  To ensure that one or more events occur in a specified sequence. 
  9668.  
  9669.  serially reusable resource (SRR)  A logical resource or object that can be 
  9670.    accessed by only one task at a time. 
  9671.  
  9672.  session  (1) A routing mechanism for user interaction via the console; a 
  9673.    complete environment that determines how an application runs and how users 
  9674.    interact with the application. OS/2 can manage more than one session at a 
  9675.    time, and more than one process can run in a session. Each session has its 
  9676.    own set of environment variables that determine where OS/2 looks for 
  9677.    dynamic-link libraries and other important files. (2) (D of C) In the OS/2 
  9678.    operating system, one instance of a started program or command prompt. Each 
  9679.    session is separate from all other sessions that might be running on the 
  9680.    computer. The operating system is responsible for coordinating the resources 
  9681.    that each session uses, such as computer memory, allocation of processor 
  9682.    time, and windows on the screen. 
  9683.  
  9684.  Settings Notebook  A control window that is used to display the settings for 
  9685.    an object and to enable the user to change them. 
  9686.  
  9687.  shadow  An object that refers to another object. A shadow is not a copy of 
  9688.    another object, but is another representation of the object. 
  9689.  
  9690.  shadow box  The area on the screen that follows mouse movements and shows what 
  9691.    shape the window will take if the mouse button is released. 
  9692.  
  9693.  shared data  Data that is used by two or more programs. 
  9694.  
  9695.  shared memory  In the OS/2 operating system, a segment that can be used by 
  9696.    more than one program. 
  9697.  
  9698.  shear  In computer graphics, the forward or backward slant of a graphics 
  9699.    symbol or string of such symbols relative to a line perpendicular to the 
  9700.    baseline of the symbol. 
  9701.  
  9702.  shell  (1) A software interface between a user and the operating system of a 
  9703.    computer. Shell programs interpret commands and user interactions on devices 
  9704.    such as keyboards, pointing devices, and touch-sensitive screens, and 
  9705.    communicate them to the operating system. (2) Software that allows a kernel 
  9706.    program to run under different operating-system environments. 
  9707.  
  9708.  shutdown  The process of ending operation of a system or a subsystem, 
  9709.    following a defined procedure. 
  9710.  
  9711.  sibling processes  Child processes that have the same parent process. 
  9712.  
  9713.  sibling windows  Child windows that have the same parent window. 
  9714.  
  9715.  simple list  A list of like values; for example, a list of user names. 
  9716.    Contrast with mixed list. 
  9717.  
  9718.  single-byte character set (SBCS)  A character set in which each character is 
  9719.    represented by a one-byte code.  Contrast with double-byte character set. 
  9720.  
  9721.  slider box  In SAA Advanced Common User Access architecture: a part of the 
  9722.    scroll bar that shows the position and size of the visible information in a 
  9723.    window relative to the total amount of information available. Also known as 
  9724.    thumb mark. 
  9725.  
  9726.  SOM  System Object Model. 
  9727.  
  9728.  source file  A file that contains source statements for items such as 
  9729.    high-level language programs and data description specifications. 
  9730.  
  9731.  source statement  A statement written in a programming language. 
  9732.  
  9733.  specific dynamic-link module  A dynamic-link module created for the exclusive 
  9734.    use of an application. 
  9735.  
  9736.  spin button  In SAA Advanced Common User Access architecture, a type of entry 
  9737.    field that shows a scrollable ring of choices from which a user can select a 
  9738.    choice. After the last choice is displayed, the first choice is displayed 
  9739.    again.  A user can also type a choice from the scrollable ring into the 
  9740.    entry field without interacting with the spin button. 
  9741.  
  9742.  spline  A sequence of one or more B╨Æzier curves. 
  9743.  
  9744.  spooler  A program that intercepts the data going to printer devices and 
  9745.    writes it to disk. The data is printed or plotted when it is complete and 
  9746.    the required device is available.  The spooler prevents output from 
  9747.    different sources from being intermixed. 
  9748.  
  9749.  stack  A list constructed and maintained so that the next data element to be 
  9750.    retrieved is the most recently stored. This method is characterized as 
  9751.    last-in-first-out (LIFO). 
  9752.  
  9753.  standard window  A collection of window elements that form a panel. The 
  9754.    standard window can include one or more of the following window elements: 
  9755.    sizing borders, system menu icon, title bar, maximize/minimize/restore 
  9756.    icons, action bar and pull-downs, scroll bars, and client area. 
  9757.  
  9758.  static control  The means by which the application presents descriptive 
  9759.    information (for example, headings and descriptors) to the user. The user 
  9760.    cannot change this information. 
  9761.  
  9762.  static storage  (1) A read/write storage unit in which data is retained in the 
  9763.    absence of control signals. (A)  Static storage may use dynamic addressing 
  9764.    or sensing circuits. (2) Storage other than dynamic storage. (A)
  9765.  
  9766.  style  See window style. 
  9767.  
  9768.  subclass  A class that is a child of another class. See also Inheritance. 
  9769.  
  9770.  subdirectory  In an IBM personal computer, a file referred to in a root 
  9771.    directory that contains the names of other files stored on the diskette or 
  9772.    fixed disk. 
  9773.  
  9774.  swapping  (1) A process that interchanges the contents of an area of real 
  9775.    storage with the contents of an area in auxiliary storage. (I)  (A)  (2) In 
  9776.    a system with virtual storage, a paging technique that writes the active 
  9777.    pages of a job to auxiliary storage and reads pages of another job from 
  9778.    auxiliary storage into real storage. (3) The process of temporarily removing 
  9779.    an active job from main storage, saving it on disk, and processing another 
  9780.    job in the area of main storage formerly occupied by the first job. 
  9781.  
  9782.  switch  (1) In SAA usage, to move the cursor from one point of interest to 
  9783.    another;  for example, to move from one screen or window to another or from 
  9784.    a place within a displayed image to another place on the same displayed 
  9785.    image. (2) In a computer program, a conditional instruction and an indicator 
  9786.    to be interrogated by that instruction. (3) A device or programming 
  9787.    technique for making a selection, for example, a toggle, a conditional jump. 
  9788.  
  9789.  switch list  See Task List. 
  9790.  
  9791.  symbolic identifier  A text string that equates to an integer value in an 
  9792.    include file, which is used to identify a programming object. 
  9793.  
  9794.  symbols  In Information Presentation Facility, a document element used to 
  9795.    produce characters that cannot be entered from the keyboard. 
  9796.  
  9797.  synchronous  Pertaining to two or more processes that depend upon the 
  9798.    occurrence of specific events such as common timing signals. (T)  See also 
  9799.    asynchronous. 
  9800.  
  9801.  System Menu  In the Presentation Manager, the pull-down in the top left corner 
  9802.    of a window that allows it to be moved and sized with the keyboard. 
  9803.  
  9804.  System Object Model (SOM)  A mechanism for language-neutral, object-oriented 
  9805.    programming in the OS/2 environment. 
  9806.  
  9807.  system queue  The master queue for all pointer device or keyboard events. 
  9808.  
  9809.  system-defined messages  Messages that control the operations of applications 
  9810.    and provides input an other information for applications to process. 
  9811.  
  9812.  Systems Application Architecture (SAA)  A set of IBM software interfaces, 
  9813.    conventions, and protocols that provide a framework for designing and 
  9814.    developing applications that are consistent across systems. 
  9815.  
  9816.  
  9817. ΓòÉΓòÉΓòÉ <hidden> Glossary - T ΓòÉΓòÉΓòÉ
  9818.  
  9819.  table tags  In Information Presentation Facility, a document element that 
  9820.    formats text in an arrangement of rows and columns. 
  9821.  
  9822.  tag  (1) One or more characters attached to a set of data that contain 
  9823.    information about the set, including its identification. (I)  (A)  (2) In 
  9824.    Generalized Markup Language markup, a name for a type of document or 
  9825.    document element that is entered in the source document to identify it. 
  9826.  
  9827.  target object  An object to which the user is transferring information. 
  9828.  
  9829.  Task List  In the Presentation Manager, the list of programs that are active. 
  9830.    The list can be used to switch to a program and to stop programs. 
  9831.  
  9832.  terminate-and-stay-resident (TSR)  Pertaining to an application that modifies 
  9833.    an operating system interrupt vector to point to its own location (known as 
  9834.    hooking an interrupt). 
  9835.  
  9836.  text  Characters or symbols. 
  9837.  
  9838.  text cursor  A symbol displayed in an entry field that indicates where typed 
  9839.    input will appear. 
  9840.  
  9841.  text window  Also known as the VIO window. 
  9842.  
  9843.  text-windowed application  The environment in which the operating system 
  9844.    performs advanced-video input and output operations. 
  9845.  
  9846.  thread  A unit of execution within a process. It uses the resources of the 
  9847.    process. 
  9848.  
  9849.  thumb mark  The portion of the scroll bar that describes the range and 
  9850.    properties of the data that is currently visible in a window. Also known as 
  9851.    a slider box. 
  9852.  
  9853.  thunk  Term used to describe the process of address conversion, stack and 
  9854.    structure realignment, etc., necessary when passing control between 16-bit 
  9855.    and 32-bit modules. 
  9856.  
  9857.  tilde  A mark used to denote the character that is to be used as a mnemonic 
  9858.    when selecting text items within a menu. 
  9859.  
  9860.  time slice  (1) An interval of time on the processing unit allocated for use 
  9861.    in performing a task. After the interval has expired, processing-unit time 
  9862.    is allocated to another task, so a task cannot monopolize processing-unit 
  9863.    time beyond a fixed limit. (2) In systems with time sharing, a segment of 
  9864.    time allocated to a terminal job. 
  9865.  
  9866.  time-critical process  A process that must be performed within a specified 
  9867.    time after an event has occurred. 
  9868.  
  9869.  timer  A facility provided under the Presentation Manager, whereby 
  9870.    Presentation Manager will dispatch a message of class WM_TIMER to a 
  9871.    particular window at specified intervals. This capability may be used by an 
  9872.    application to perform a specific processing task at predetermined 
  9873.    intervals, without the necessity for the application to explicitly keep 
  9874.    track of the passage of time. 
  9875.  
  9876.  timer tick  See clock tick. 
  9877.  
  9878.  title bar  In SAA Advanced Common User Access architecture, the area at the 
  9879.    top of each window that contains the window title and system menu icon. When 
  9880.    appropriate, it also contains the minimize, maximize, and restore icons. 
  9881.    Contrast with panel title. 
  9882.  
  9883.  TLB  Translation lookaside buffer. 
  9884.  
  9885.  transaction  An exchange between a workstation and another device that 
  9886.    accomplishes a particular action or result. 
  9887.  
  9888.  transform  (1) The action of modifying a picture by scaling, shearing, 
  9889.    reflecting, rotating, or translating. (2) The object that performs or 
  9890.    defines such a modification; also referred to as a transformation. 
  9891.  
  9892.  Translation lookaside buffer (TLB)  A hardware-based address caching mechanism 
  9893.    for paging information. 
  9894.  
  9895.  Tree  In the Presentation Manager, the window in the File Manager that shows 
  9896.    the organization of drives and directories. 
  9897.  
  9898.  truncate  (1) To terminate a computational process in accordance with some 
  9899.    rule (A)  (2) To remove the beginning or ending elements of a string. (3) To 
  9900.    drop data that cannot be printed or displayed in the line width specified or 
  9901.    available. (4) To shorten a field or statement to a specified length. 
  9902.  
  9903.  TSR  Terminate-and-stay-resident. 
  9904.  
  9905.  unnamed pipe  A circular buffer, created in memory, used by related processes 
  9906.    to communicate with one another. Contrast with named pipe. 
  9907.  
  9908.  unordered list  In Information Presentation Facility, a vertical arrangement 
  9909.    of items in a list, with each item in the list preceded by a special 
  9910.    character or bullet. 
  9911.  
  9912.  update region  A system-provided area of dynamic storage containing one or 
  9913.    more (not necessarily contiguous) rectangular areas of a window that are 
  9914.    visually invalid or incorrect, and therefore are in need of repainting. 
  9915.  
  9916.  user interface  Hardware, software, or both that allows a user to interact 
  9917.    with and perform operations on a system, program, or device. 
  9918.  
  9919.  User Shell  A component of OS/2 that uses a graphics-based, windowed interface 
  9920.    to allow the user to manage applications and files installed and running 
  9921.    under OS/2. 
  9922.  
  9923.  utility program  (1) A computer program in general support of computer 
  9924.    processes; for example, a diagnostic program, a trace program, a sort 
  9925.    program. (T)  (2) A program designed to perform an everyday task such as 
  9926.    copying data from one storage device to another. (A)
  9927.  
  9928.  
  9929. ΓòÉΓòÉΓòÉ <hidden> Glossary - U ΓòÉΓòÉΓòÉ
  9930.  
  9931. There are no glossary terms for this starting letter. 
  9932.  
  9933.  
  9934. ΓòÉΓòÉΓòÉ <hidden> Glossary - V ΓòÉΓòÉΓòÉ
  9935.  
  9936.  value set control  A visual component that enables a user to select one choice 
  9937.    from a group of mutually exclusive choices. 
  9938.  
  9939.  vector font  A set of symbols, each of which is created as a series of lines 
  9940.    and curves. Synonymous with outline font. Contrast with image font. 
  9941.  
  9942.  VGA  Video graphics array. 
  9943.  
  9944.  view  A way of looking at an object's information. 
  9945.  
  9946.  viewing pipeline  The series of transformations applied to a graphic object to 
  9947.    map the object to the device on which it is to be presented. 
  9948.  
  9949.  viewing window  A clipping boundary that defines the visible part of model 
  9950.    space. 
  9951.  
  9952.  VIO  Video Input/Output. 
  9953.  
  9954.  virtual memory (VM)  Synonymous with virtual storage. 
  9955.  
  9956.  virtual storage  (1) The storage space that may be regarded as addressable 
  9957.    main storage by the user of a computer system in which virtual addresses are 
  9958.    mapped into real addresses. The size of virtual storage is limited by the 
  9959.    addressing scheme of the computer system and by the amount of auxiliary 
  9960.    storage available, not by the actual number of main storage 
  9961.    locations. (I)  (A)  (2) Addressable space that is apparent to the user as 
  9962.    the processor storage space, from which the instructions and the data are 
  9963.    mapped into the processor storage locations. (3) Synonymous with virtual 
  9964.    memory. 
  9965.  
  9966.  visible region  A window's presentation space, clipped to the boundary of the 
  9967.    window and the boundaries of any overlying window. 
  9968.  
  9969.  volume  (1) A file-system driver that uses a block device driver for input and 
  9970.    output operations to a local or remote device. (I)  (2) A portion of data, 
  9971.    together with its data carrier, that can be handled conveniently as a unit. 
  9972.  
  9973.  
  9974. ΓòÉΓòÉΓòÉ <hidden> Glossary - W ΓòÉΓòÉΓòÉ
  9975.  
  9976.  wildcard character  Synonymous with global file-name character. 
  9977.  
  9978.  window  (1) A portion of a display surface in which display images pertaining 
  9979.    to a particular application can be presented. Different applications can be 
  9980.    displayed simultaneously in different windows. (A)  (2) An area of the 
  9981.    screen with visible boundaries within which information is displayed. A 
  9982.    window can be smaller than or the same size as the screen. Windows can 
  9983.    appear to overlap on the screen. 
  9984.  
  9985.  window class  The grouping of windows whose processing needs conform to the 
  9986.    services provided by one window procedure. 
  9987.  
  9988.  window coordinates  A set of coordinates by which a window position or size is 
  9989.    defined; measured in device units, or pels. 
  9990.  
  9991.  window handle  Unique identifier of a window, generated by Presentation 
  9992.    Manager when the window is created, and used by applications to direct 
  9993.    messages to the window. 
  9994.  
  9995.  window procedure  Code that is activated in response to a message. The 
  9996.    procedure controls the appearance and behavior of its associated windows. 
  9997.  
  9998.  window rectangle  The means by which the size and position of a window is 
  9999.    described in relation to the desktop window. 
  10000.  
  10001.  window resource  A read-only data segment stored in the .EXE file of an 
  10002.    application o the .DLL file of a dynamic link library. 
  10003.  
  10004.  window style  The set of properties that influence how events related to a 
  10005.    particular window will be processed. 
  10006.  
  10007.  window title  In SAA Advanced Common User Access architecture, the area in the 
  10008.    title bar that contains the name of the application and the OS/2 operating 
  10009.    system file name, if applicable. 
  10010.  
  10011.  Workplace Shell  The OS/2 object-oriented, graphical user interface. 
  10012.  
  10013.  workstation  (1) A display screen together with attachments such as a 
  10014.    keyboard, a local copy device, or a tablet. (2) (D of C) One or more 
  10015.    programmable or nonprogrammable devices that allow a user to do work. 
  10016.  
  10017.  world coordinates  A device-independent Cartesian coordinate system used by 
  10018.    the application program for specifying graphical input and output. (I)  (A)
  10019.  
  10020.  world-coordinate space  Coordinate space in which graphics are defined before 
  10021.    transformations are applied. 
  10022.  
  10023.  WYSIWYG  What-You-See-Is-What-You-Get. A capability of a text editor to 
  10024.    continually display pages exactly as they will be printed. 
  10025.  
  10026.  
  10027. ΓòÉΓòÉΓòÉ <hidden> Glossary - X ΓòÉΓòÉΓòÉ
  10028.  
  10029. There are no glossary terms for this starting letter. 
  10030.  
  10031.  
  10032. ΓòÉΓòÉΓòÉ <hidden> Glossary - Y ΓòÉΓòÉΓòÉ
  10033.  
  10034. There are no glossary terms for this starting letter. 
  10035.  
  10036.  
  10037. ΓòÉΓòÉΓòÉ <hidden> Glossary - Z ΓòÉΓòÉΓòÉ
  10038.  
  10039.  z-order  The order in which sibling windows are presented. The topmost sibling 
  10040.    window obscures any portion of the siblings that it overlaps; the same 
  10041.    effect occurs down through the order of lower sibling windows. 
  10042.  
  10043.  zooming  The progressive scaling of an entire display image in order to give 
  10044.    the visual impression of movement of all or part of a display group toward 
  10045.    or away from an observer. (I)  (A)
  10046.  
  10047.  8.3 file-name format  A file-naming convention in which file names are limited 
  10048.    to eight characters before and three characters after a single dot. Usually 
  10049.    pronounced "eight-dot-three." See also non-8.3 file-name format. 
  10050.  
  10051.  
  10052. ΓòÉΓòÉΓòÉ <hidden> IBM Trademark ΓòÉΓòÉΓòÉ
  10053.  
  10054. Trademark of the IBM Corporation. 
  10055.  
  10056.  
  10057. ΓòÉΓòÉΓòÉ <hidden> Trademarks ΓòÉΓòÉΓòÉ
  10058.  
  10059. Trademark of AT&T, Inc. 
  10060.  
  10061.  
  10062. ΓòÉΓòÉΓòÉ <hidden> Trademarks ΓòÉΓòÉΓòÉ
  10063.  
  10064. Trademark of the Adobe Systems Inc. 
  10065.  
  10066.  
  10067. ΓòÉΓòÉΓòÉ <hidden> Trademarks ΓòÉΓòÉΓòÉ
  10068.  
  10069. Trademark of the Microsoft Corporation. 
  10070.  
  10071.  
  10072. ΓòÉΓòÉΓòÉ <hidden> Trademarks ΓòÉΓòÉΓòÉ
  10073.  
  10074. Trademark of Linotype. 
  10075.  
  10076.  
  10077. ΓòÉΓòÉΓòÉ <hidden> Trademarks ΓòÉΓòÉΓòÉ
  10078.  
  10079. Trademark of Monotype Corporation, Limited. 
  10080.  
  10081.  
  10082. ΓòÉΓòÉΓòÉ <hidden> Trademarks ΓòÉΓòÉΓòÉ
  10083.  
  10084. Trademark of Intel Coporation. 
  10085.  
  10086.  
  10087. ΓòÉΓòÉΓòÉ <hidden> Trademarks ΓòÉΓòÉΓòÉ
  10088.  
  10089. Trademark of Novell, Inc.