home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / pmtree / pmtree.doc < prev    next >
Encoding:
Text File  |  1992-08-17  |  3.4 KB  |  63 lines
  1. ************************************************************************
  2. *  PMTREE - Graphical display of PM windows                            *
  3. *                                                                      *
  4. *  (C) Copyright IBM Corp. 1992                                        *
  5. *                                                                      *
  6. *  Author: Donald Hobern                                               *
  7. ************************************************************************
  8.  
  9. PMTREE is an application for examination of and interaction with the
  10. windows of an OS/2 system.  It is a 32-bit Presentation Manager
  11. application that will run on OS/2 2.0, but not previous versions of
  12. OS/2.
  13.  
  14. All activity centres around a graphical display of a window hierarchy
  15. shown in the client area of the main window.  A window is represented at
  16. the top left by a rectangle accompanied by descriptions of various
  17. features of the window.  Its immediate children are represented by a
  18. series of rectangles arranged in a column to the right of this 'head'
  19. window.  Similarly their children may be represented to the right of
  20. their representations, for as many levels as the hierarchy of windows
  21. extends. Different window classes are represented in different colours.
  22. The user is also able to select any one of the system defined window
  23. styles from the menu.  Subsequently all windows which have that style
  24. flag set will be represented in reverse colours.
  25.  
  26. Extra information is displayed under the head window representation.
  27. This comprises the window id, the process and thread ids, the owner
  28. window (if there is one), the window position and size, the window style
  29. (broken into the constituent flags), the minimise and restore positions
  30. and sizes (where applicable), the window procedure address and, for menu
  31. windows the item ids contained in the menu (and item texts for the
  32. PMTREE process and when the Extensions option has been selected), for
  33. frame windows the FF_ flag names and accelerator table handle and table
  34. contents, and for listboxes and combo boxes the number of items in a
  35. listbox.
  36.  
  37. For convenience the tree may be simplified by displaying only one level
  38. of children.  Alternatively the user can disable branches of the tree
  39. by double clicking the 'manipulation button' of the mouse over the
  40. representation of a window.  In both cases uncharted branches will be
  41. indicated by "+ + +".
  42.  
  43. The user may choose to bring up a dialog to change various values
  44. associated with any window (size, position, window text, style, id,
  45. parent, owner).  These options should be used with care.  There are many
  46. ways to hang the system and it is not practical to try to detect all
  47. such cases and disallow them.
  48.  
  49. The user may also bring up another dialog that allows a large number of
  50. different messages to be sent, posted or broadcast to the window.  These
  51. messages can pass pointers to data including text strings in their
  52. parameters.
  53.  
  54. /n, /x and /r are command line parameters that will bring the main window
  55. up minimised, maximised and restored respectively.  Otherwise PMTREE will
  56. reuse the position and size that it occupied when last used.  PMTREE can
  57. remember settings, window selection and window position across
  58. invocations.
  59.  
  60. The application is supplied with help that describes in fuller detail
  61. how to use the menu options supplied and how to use PMTREE to interact
  62. with the windows of the Presentation Manager system.
  63.