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