home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1999 April / PCO0499.ISO / filesbbs / os2 / smw82b.arj / SMW082.ZIP / smartwin.txt < prev    next >
Encoding:
Text File  |  1999-01-20  |  36.1 KB  |  806 lines

  1.  
  2.                           Styler/2 (Smart Windows)
  3.  
  4.  
  5.      [*] License agreement
  6.      [*] Introduction
  7.      [*] What's new
  8.      [*] Installation-uninstallation
  9.      [*] Features and settings
  10.      [*] Known problems
  11.      [*] Planned features
  12.      [*] Registration
  13.  
  14.                    --------------------------------------
  15.  
  16. License agreement
  17.  
  18.    * Under no circumstances the author is liable for any loss or damage.
  19.    * You are free to use this version of the program on as many machines as
  20.      you like.
  21.    * You are free to distribute the program provided that you include all
  22.      the files in the archive without any modification.
  23.    * You are not allowed to sell the program, but can charge a reasonable
  24.      amount to cover the cost of the distribution media.
  25.  
  26. The use of the program implies acceptance of the conditions stated above!
  27.  
  28. Alessandro Cantatore
  29. alexcant@tin.it
  30. alexcant@pandora.it
  31. FIDONET: 2:335/705.2
  32. http://acsoft.ghostbbs.cx
  33.  
  34.  
  35. Introduction
  36.  
  37. Styler/2, previously known as Smart Windows, is an user interface enhancer
  38. for OS/2 warp 3 and 4. Both the aesthetics and the behaviour of various
  39. OS/2 Presentation manager windows and controls can be easily modified to
  40. meet your needs.
  41. You wiil be able to use bitmaps or shades as titlebar background, choose
  42. any bitmap (of appropriate size) for the window buttons and force all
  43. dialog windows to use your favourite font.
  44.  
  45. Other features include window rolling, titlebar hiding, overriding the
  46. default size and position of maximized windows, moving windows by dragging
  47. their frame, pushing windows behind the other windows, selection of the
  48. entry fields contents, autofocus, mouse pointer hiding, mouse button double
  49. click emulation and automatically moving the mouse pointer to the focus
  50. window.
  51. This beta version is fully functional and will work for 90 days since
  52. installation or for 600 reboots whichever comes first.
  53. I'm still working on version 0.9 which will be the first shareware
  54. (registrable) version and will be renamed Styler/2.
  55.  
  56.  
  57. What's new
  58.  
  59. This version (0.82 - smw082.zip) corrects the following problems:
  60.  
  61.   1. In systems running at 256 colors, after the system palette was changed
  62.      by some applications, the titlebar bitmaps weren't able to reset their
  63.      colors. Now the bitmaps are refreshed and properly displayed as soon
  64.      as the default system palette is reloaded and the window owning the
  65.      titlebar gets the focus.
  66.   2. In some cases, moving windows in rolled state, was preventing them to
  67.      be unrolled later.
  68.   3. In some cases, OS/2 and DOS command windows were disappearing from the
  69.      screen when rolled and then unrolled.
  70.   4. Titlebar and window controls were misplaced when unrolling maximized
  71.      windows previously rolled, when the Override default size and position
  72.      was set.
  73.   5. The Automatic focus feature was preventing drop down menus to work
  74.      correctly in seamless winOS/2 windows.
  75.   6. The Move the pointer to the focus window feature has been improved.
  76.   7. The Enable checkbox in the Functions controlled by the mouse dialog
  77.      and in the Mouse mapping page now work as expected.
  78.   8. The bug which prevented to set permanently negative positions for
  79.      maximized windows has been removed.
  80.  
  81.  
  82. Installation-uninstallation
  83.  
  84. The program can be installed over a previous installation of Smart Windows
  85. V. 0.81 (any patch level) without any need to disable the application or to
  86. uninstall it. If you installed a version older than V.0.81 you must delete
  87. the SMARTWIN.INI file from the installation path before installing this
  88. version.
  89.  
  90. The archive smw082.zip must be unzipped in a temporary directory preserving
  91. the path of the archive content.
  92. If you are using the free GNU Info-UNZIP this will be made by default: open
  93. a an OS/2 command window, move to the temporary directory and type:
  94.  
  95. UNZIP SMW082.ZIP
  96.  
  97. If you are using a different program read the program documentation for the
  98. appropriate parameters.
  99.  
  100. Once unzipped the archive you must run INSTALL.EXE and click on the
  101. Install button for a new installation or for updating your previous
  102. installation.
  103. To save users' download time smw082.zip doesn't contain all the bitmap
  104. files included in the previous versions. If you are installing over a
  105. previous installation, you will already have all the bitmap files in the
  106. right palces. If you are performing a new installation and still have
  107. smw081.zip you can drag its \BITMAPS directory into the temporary directory
  108. where you unpacked smw082.zip overwriting the folder with the same name.
  109. Before doing that modify your system configuration (System object,
  110. Confirmations page) checking to Confirm on copy, move, create shadow . So
  111. you will be able to confirm file overwriting just once for all files
  112. reather than many times for each individual file.
  113. If you do not have smw081.zip, you can get smwb082.zip and install the
  114. enclosed \BITMAPS tree as described above.
  115. If you modified some bitmap files leaving their name unchanged, rename them
  116. or backup them before installing to prevent them to be overwritten. (The
  117. next version of the installer will check for the file date stamps to avoid
  118. that).
  119. The other program buttons have the following functions:
  120.  
  121.   1. The Refresh button works only if the program is currently installed
  122.      and allow to re-create the Smart Windows folder and desktop objects.
  123.   2. The Uninstall button completely removes all files from the
  124.      installation path and other paths and clean the CONFIG.SYS and the
  125.      OS2.INI files.
  126.   3. The Help button displays this documentation in plain text format.
  127.   4. The Exit button terminates the the application.
  128.  
  129. As you move the mouse pointer around a short information message will be
  130. shown in the application status bar.
  131.  
  132. Installation details
  133.  
  134. This is, step by step, what the happens when you click on the Install
  135. button. Please refer to this section if you cannot properly install the
  136. program on your system.
  137.  
  138.   1. The installation program first looks for the flag file SMARTWIN.@ to
  139.      enable the Install button, then looks in the \OS2\DLL directory and
  140.      the OS2.INI file for any item from a previous installation.
  141.      If any trace of a previous installation is found (or if you run the
  142.      Smart Windows Installer object later) the Refresh and Uninstall button
  143.      will be enabled as well.
  144.   2. During initialization the program checks if SMARTWIN.DLL is loaded in
  145.      memory. In same case this will make a message box to pop-up with the
  146.      text Registration error #5 . Please ignore it and go on with the
  147.      installation.
  148.      In any case if the DLL is found in the \OS2\DLL directory a message
  149.      box asks your confirmation for overwriting it. Click on Yes and go to
  150.      the next step.
  151.   3. A dialog box allows you to select the drive and path where to install
  152.      the files. The default drive is your boot drive and the default path
  153.      is \SMARTWIN unless you are upgrading a previous installation, in
  154.      which case the previous installation path will be the default.
  155.      Although, during uninstallation, once deleted the program files, a
  156.      message box will ask your permission before removing the installation
  157.      path and all its contents it is advisable not to install the program
  158.      files in a directory which contains other files.
  159.      If the selected path doesn't exist, the program will create all the
  160.      necessary directories. For instance if you selected to install the
  161.      program files in C:\APPS\TEST\SMW and none of the directories in the
  162.      path exist the installation program will create all of them.
  163.   4. The next step consists in updating the OS2.INI file:
  164.         o a Smart Windows application is added to store the installation
  165.           path and few other informations.
  166.         o the SMARTWIN module name is added to the list of the DLLs to be
  167.           loaded every time a new process is started (SYS_DLLS -
  168.           LoadPerProcess )
  169.   5. After that, if this is a new installation rather than an upgrade, the
  170.      installer asks if you want that, the first time, Smart Windows be
  171.      started with the default options (click on the "Yes" button) or with
  172.      all the options disabled (click on the "No" button).
  173.   6. The following files are then copied to the selected installation path:
  174.         o SMARTWIN.TXT
  175.         o 3DCTLS.DLL
  176.         o EDITCOL.DLL
  177.         o PROGRESS.DLL
  178.         o SMWUTIL.DLL
  179.         o INSTALL.EXE
  180.         o SMARTWIN.EXE
  181.         o SMW001.DLL
  182.   7. Later the BITMAPS directory, all its subdirectories and their contents
  183.      are copied in the same path.
  184.   8. If a previous version of the program is installed and SMARTWIN.DLL is
  185.      loaded in memory it is unlocked. In any case the new SMARTWIN.DLL is
  186.      copied in \OS2\DLL. A future version of the installer will allow you
  187.      to choose any directory mentioned in your CONFIG.SYS LIBPATH
  188.      statement.
  189.   9. The SMWERROR.MSG file is copied in \OS2. A future version of the
  190.      installer will allow you to choose any directory mentioned in your
  191.      CONFIG.SYS DPATH statement.
  192.  10. Your CONFIG.SYS file is checked and, if necessary it will be modified
  193.      to include the lines:
  194.      REM --- Smart Windows environment --- LEAVE IT AS THE FIRST \"SET\"
  195.      STATEMENT!!!
  196.      SET SMWENV=AAAAAAAA
  197.  11. A Smart Windows folder with the Smart Windows Properties ,Readme and
  198.      Smart Windows Installer objects is created on the Desktop.
  199.  12. All operations performed by the installation procedure will be
  200.      reported in the SMWSETUP.LOG file in the installation path.
  201.  13. After installation you must reboot in order to load the new
  202.      SMARTWIN.DLL.
  203.  
  204. Uninstallation details
  205.  
  206. The uninstallation procedure undoes all the above described operations.
  207. Besides that it will delete any new bitmap files you added in the \BITMAPS
  208. subdirectories. Anyway a message box asks you to confirm the deletion of
  209. the installation path and other files which can still be there
  210. (SMARTWIN.INI which is created by the application or any other files you
  211. put there).
  212. At the end of the uninstallation procedure the SMWSETUP.LOG file will be
  213. written in the root of the boot drive.
  214.  
  215.  
  216. Features and settings
  217.  
  218. The program consists in a DLL which is loaded by the system every time a
  219. new process is started and in a preferences notebook which allows to let
  220. the DLL use your favourite settings.
  221. The notebook pages share a common area with a statusbar which provide
  222. contextual help and a five buttons toolbar. The preferences window is
  223. resizeable! If you cannot read some help message because it doesn't fit the
  224. statusbar control, you can resize the window making it wider.
  225. The toolbar buttons have the following functions:
  226.  
  227.  [Enable/disable button]The first button enables/disables all Smart
  228.                         Windows features.
  229.  [Apply button]         This button is required to apply the settings of
  230.                         the current page. Most pages do not need it since
  231.                         the settings are effective as soon as they are
  232.                         changed. When required, the button is enabled as
  233.                         soon as a setting is modified.
  234.  [Undo button]          The third button is an undo button. It will set
  235.                         the settings of the current page to the values
  236.                         they held when the Preferences application was
  237.                         started.
  238.  [Default button]       The forth button is the default button and it
  239.                         resets the current page preferences to the default
  240.                         values.
  241.  [Help button]          The fifth button is the help button. There is no
  242.                         SMARTWIN.HLP file yet so it doesn't work.
  243.  
  244. There are still a lot of features not yet implemented though the
  245. corresponding buttons/checkboxes are in the Preferences application.
  246.  
  247. The Smart Windows Preferences notebook consists of the following pages:
  248.  
  249.    * Smart Windows
  250.         o Product information (just the logo and the version number)
  251.         o General
  252.         o Exceptions
  253.    * Dialogs
  254.         o General options
  255.         o Exceptions
  256.    * Titlebar
  257.         o Active window
  258.         o Inactive window
  259.         o Titlebar hiding
  260.         o Exceptions
  261.    * Window rolling
  262.         o General options
  263.         o Exceptions
  264.    * Maximized windows
  265.         o General options
  266.         o Exceptions
  267.    * Sizing/moving
  268.         o General options
  269.         o Exceptions
  270.    * Text controls
  271.         o General options
  272.         o Exceptions
  273.    * VIO windows
  274.         o General options
  275.         o Exceptions
  276.    * Mouse
  277.         o General options
  278.         o Exceptions
  279.         o Mapping
  280.    * Keyboard
  281.         o Mapping
  282.  
  283. Other dialogs used by the application are:
  284.  
  285.    * The bitmap selection dialog
  286.    * The mouse/keyboard funtions dialog
  287.  
  288.  Smart Windows - General
  289.  The settings in this page affect the behaviour of the preferences
  290.  notebook itself:
  291.  
  292.  Apply on exit
  293.       All new settings will be automatically applied when the
  294.       program window is closed.
  295.  Save on exit
  296.       if not checked the current settings are not saved in
  297.       SMARTWIN.INI so when you reboot you'll get back the previous
  298.       settings.
  299.  Remeber last viewed page
  300.       this option works when the program is started and brings to
  301.       the the top the page which was the topmost page when the
  302.       program was closed.
  303.  Apply all
  304.       simulates clicking on the Apply button in all pages which
  305.       require that to make the current prefrences the active ones.
  306.  Undo all
  307.       simulates clicking on the Undo button in all pages where
  308.       some settings have been modified.
  309.  Default all
  310.       simulates clicking on the Default button in all pages.
  311.  
  312.  Exceptions and Exceptions pages
  313.  Although the program integrates seamlessly with the system,
  314.  generally with no problem for all the other programs, there are
  315.  still some applications which cannot properly cooperate with it
  316.  and which won't work properly when some Smart Windows features
  317.  have been set.
  318.  In order to avoid this kind of problems each page grouping a
  319.  category of features is followed by a an Exceptions page which
  320.  will allow you to enter the name of the programs for which that
  321.  particular group of options causes conflicts.
  322.  In some cases you would find more confortable just to completely
  323.  disable Smart Windows enhancements for a given program. For this
  324.  purpose you should use the Exception page inserted under the
  325.  Smart Windows main tab.
  326.  To add a program to the exception list either type its full name
  327.  (i.e. including the program path) in the entry field and click on
  328.  the Add button or get it from the file dialog clicking on the
  329.  Find button. The Remove button will delete a file name from the
  330.  list.
  331.  
  332.  Note: currently it is not possible to specify the name of
  333.  programs whose windows are executed as a PMSHELL process. These
  334.  are: all text mode programs (DOS and OS/2), all Win-OS/2
  335.  programs, all fodlers and all WPS applications (like the System
  336.  clock, the color and font palettes, etc.).
  337.  
  338.  In future all this scattered Exceptions pages will be grouped in
  339.  a unique dialog and will be possible to add program names by darg
  340.  and drop or directly by the system menu of a running application
  341.  and to detect the various windows belonging to the PMSHELL
  342.  process.
  343.  
  344.  Dialogs
  345.  Usually, when no other kind of font has been explicitly specified
  346.  by the programmer, all dialog windows will use the ugly System
  347.  Proportional font.
  348.  Smart Windows allows to override this system behaviour and force
  349.  all dialog windows to use your favourite font. Just check Use
  350.  Smart Windows font to enable this function.
  351.  This will work in all dialog windows which use the system default
  352.  font. If you want to force all windows to use the font you
  353.  selected then check Override Presentation Parameters .
  354.  The Font button brings to the top the Dialog font dialog.
  355.  Note: dialog controls inherit the font attribute (presentation
  356.  parameter) from the dialog unless they have been explicitly set
  357.  to use a different font. In this latter case the Use Smart
  358.  Windows font feature won't work.
  359.  
  360.  Titlebar - Active window/Inactive window
  361.  Through this page it is possible to change completely the look of
  362.  titlebars.
  363.  
  364.  You can use any bitmap for the titlebar background or the window
  365.  controls with the following limitations:
  366.  
  367.     * all bitmaps must be in warp 2.x format not RLE packed.
  368.     * the titlebar bitmap file size must be less than 8 KB.
  369.     * the titlebar bitmap must be at least 22 pixels high for
  370.       screen resolutions of 1024x768 pixels or better or 18 pixel
  371.       for screen resolutions fo 800x600 pixels or less.
  372.     * the window controls bitmaps must be 16 colors bitmaps, 22x22
  373.       pixels for high resolution screens and 18x18 pixels for low
  374.       resolution screens.
  375.  
  376.  The settings in this page must be applied through the Apply
  377.  button to become active.
  378.  
  379.  Enable titlebar enhancements
  380.       enables/disables all the controls in the page and the
  381.       corresponding settings. When it is checked a titlebar sample
  382.       will be displayed.
  383.  Context menu
  384.       a context menu event (right or left button click according
  385.       to what you set in the system mouse preferences) on the
  386.       titlebar will make the system menu popup next to the mouse
  387.       pointer.
  388.  Titlebar sample
  389.       it is interactive! By clicking on the titlebar buttons you
  390.       can modify the default buttons bitmaps or the close button
  391.       position. By clicking on the titlebar you'll be able to
  392.       select a different background color, shade direction or
  393.       bitmap according to the selected background mode.
  394.  
  395.       Background group:
  396.  Solid color
  397.       replicates the default titlebar style. The Background button
  398.       allows to select the background color. The titlebar sample
  399.       can be used like the color selection button.
  400.  Shade
  401.       allow the use of a shade as titlebar background. When
  402.       selected will display four buttons to select the two
  403.       different colors, swap them or change the shade direction.
  404.       The titlebar sample can be used like the shade direction
  405.       button.
  406.  Bitmap
  407.       allow to use a bitmap as titlebar background. When selected
  408.       a bitmap selection button will be displayed. The titlebar
  409.       sample can be used like the bitmap selection button.
  410.  Override Presentation Parameters
  411.       when unchecked titlebars which do not use default colors for
  412.       the active or inactive state, won't use the Smart Windows
  413.       titlebar background settings.
  414.  3D border group:
  415.  This setting allows to surround the titlebar with a 3D border.
  416.  The buttons allow to select and swap the colors.
  417.  
  418.  Text style group:
  419.  3D text
  420.       when checked gives a 3D effect to the text. By selecting the
  421.       colors you can get a raised or depressed effect.
  422.  Font
  423.       the Font button allow to set the titlebar font. The same
  424.       effect can be attained by dragging a font from the font
  425.       palette and dropping it on the titlebar sample.
  426.  
  427.  Note:
  428.  
  429.    1. in titlebar buttons the same bitmap is used both for the
  430.       button in ordinary state and for the button in depressed
  431.       state. The bitmap is shifted one pixel left and down for
  432.       user feedback when the button is depressed. In a future
  433.       version I'll try to use icons i.e. transparent bitmaps so to
  434.       extend the titlebar background on the buttons bottom and
  435.       different images for the different states of the buttons.
  436.    2. when moved to the left side the close buttons replicates the
  437.       system menu icon if present. The problem will be solved in a
  438.       future version.
  439.    3. next version will allow more control on the titlebar
  440.       settings:
  441.          o 3 colors shades, with some dithering and settable to
  442.            any direction (even oblique)
  443.          o pattern overlay for titlebar background
  444.          o text formatting (left, center, right)
  445.          o opaque text background etc.
  446.  
  447.  The bitmap selection dialog
  448.  This dialog will popup when you click on the titlebar sample
  449.  buttons, in the titlebar background bitmap button or in the
  450.  buttons in the Titlebar hiding and Window rolling pages.
  451.  This dialog is resizeable and its last size and position is saved
  452.  in SMARTWIN.INI.
  453.  The dialogs used for selecting the bitmaps for the close button,
  454.  window roll/unroll and titlebar hide/unhide has the Disable check
  455.  box which allows to remove the button from the titlebar controls.
  456.  
  457.  Besides that, the Close button bitmap dialog has a combobox for
  458.  selecting the button position.
  459.  
  460.  The Edit button opens the Icon editor with the bitmap currently
  461.  selected.
  462.  The Import... button copies the bitmap file selected through a
  463.  file dialog into the appropriate path and refresh the bitmap
  464.  listbox contents.
  465.  The functions of the OK and Cancel buttons are usual, while the
  466.  Help button doesn't work yet.
  467.  
  468.  Note:
  469.  Currently it is necessary to dismiss the dialog in order to
  470.  update the titlebar sample. In a future release the bitmap sample
  471.  will be updated as soon as a new bitmap is selected.
  472.  
  473.  Titlebar - Titlebar hiding
  474.  The options in this page allow to hide the titlebar and controls
  475.  (optionally including the actionbar menu) of any window. The
  476.  titlebar pops up again as soon as the mouse pointer moves on the
  477.  upper window border and is hidden when the mouse pointer is moved
  478.  away from the titlebar area downwards.
  479.  
  480.  Enable titlebar hiding
  481.       enable/disable all the titlebar hiding options.
  482.  Hide by:
  483.       System menu
  484.            add a "Titlebar hiding" item to the window system menu.
  485.       Mouse
  486.            select which mouse event, performed on the titlebar,
  487.            toggles titlebar hiding on/off.
  488.       Keyboard
  489.            (not working yet) will allow to set a keyboard
  490.            accelerator for toggling titlebar hiding on/off.
  491.       Titlebar-hide/unhide button
  492.            allows to use a titlebar button for toggling titlebar
  493.            hiding on/off. Two different bitmaps are used for
  494.            hiding/unhiding.
  495.  Exclude dialog windows
  496.       disable titlebar hiding for dialog windows. Dialog windows
  497.       without a sizing border are treated as OS/2-DOS command
  498.       windows: the titlebar is removed by reducing the size of the
  499.       window.
  500.  Include menu
  501.       hide the actionbar menu alongside the titlebar and window
  502.       controls.
  503.  Pop up delay
  504.       sets how long (hunredths of second) the mouse must stay on
  505.       the upper window border to make the hidden titlebar be
  506.       displayed.
  507.  Hide delay
  508.       sets how long the mouse pointer must stay away from the
  509.       titlebar area before the titlebar is hidden again.
  510.  
  511.  Note:
  512.  Titlebars in hidden state are hidden again only when the mouse
  513.  pointer moves downwards inside the window!
  514.  There is no reason to hide the titlebar of rolled windows so you
  515.  get just a system warning sound if you try to do so.
  516.  
  517.  Window rolling
  518.  
  519.  Enable window rolling
  520.       enable/disable all the window rolling options.
  521.  Roll by:
  522.       System menu
  523.            add a "Roll/unroll" item to the window system menu.
  524.       Mouse
  525.            select which mouse event, performed on the
  526.            titlebar,toggles window rolling on/off.
  527.       Keyboard
  528.            (not working yet) will allow to set a
  529.            keyboardaccelerator for toggling window rolling on/off.
  530.       Titlebar-roll/unroll button
  531.            allow to use a titlebarbutton for toggling window
  532.            rolling on/off. Two different bitmaps are used for
  533.            rolling/unrolling.
  534.  Auto-unroll when getting focus
  535.       rolled windows are automatically unrolled when getting
  536.       focus.
  537.  Auto-roll when losing focus
  538.       windows whose rolled state has been previously set, are
  539.       rolled as they lose focus.
  540.  Allow vertical resizing of rolled windows
  541.       disables window resizing for windows in rolled state.
  542.  Auto-unroll windows vertically resized
  543.       rolled windows are automatically unrolled if resized along
  544.       the y-axis.
  545.  Roll to the bottom
  546.       makes window roll downwards: i.e. the left bottom corner of
  547.       the window won't move.
  548.  Auto-unroll when closing window
  549.       Rolled windows are unrolled when they are closed or when the
  550.       system is closed through the default shutdown dialog.
  551.  
  552.       Note:
  553.       The Auto-roll when losing focus feature is a sub-option of
  554.       Auto unroll when getting focus feature. When both of these
  555.       features are enabled, the first roll command (through the
  556.       titlebar, system menu or roll titlebar button) sets the
  557.       window in an auto-roll state : windows in this state are
  558.       rolled/unrolled as they get/lose focus.
  559.       Untill the roll state is active, the titlebar button will
  560.       use the unroll bitmap even if the window is currently
  561.       unrolled (because it is the focus window).
  562.       If a window in auto-roll state has got the focus it is
  563.       automatically unrolled. At this point, if you want to roll
  564.       it again, while it is still the focus window, (this is
  565.       likely to happen only when you are dealing with maximized
  566.       windows) two consecutive toggle-roll-state commands are
  567.       required: the first will reset the auto-roll state, the
  568.       second one will set again the window in auto-roll state
  569.       rolling it.
  570.       In order to avoid to repeat the roll command twice, you can
  571.       keep the Shift key pressed while performing the roll
  572.       command.
  573.  
  574.  Maximized windows
  575.  These settings allow to change the behaviour of maximized
  576.  windows.
  577.  
  578.  Override default size and position
  579.       This option allows to set the position and size of windows
  580.       when they are maximized. It doesn't work for OS/2 and DOS
  581.       command windows.
  582.       The window position can be a negative number.
  583.  Don't allow moving
  584.       This option prevents maximized windows to be moved from
  585.       their default position.
  586.  Don't allow sizing
  587.       This options prevents maximized windows to be resized.
  588.  
  589.       Note:
  590.       The options not mentioned here do not work yet.
  591.  
  592.  Sizing/moving
  593.  These options control how windows are moved or resized.
  594.  
  595.  Frame drag
  596.  This option allows to move windows by moving the mouse pointer on
  597.  the window border and dragging it holding down the mouse button
  598.  and optionally some keys you can set according to your needs by
  599.  the Drag by: button.
  600.  Push behind all other windows
  601.  This option allows to move windows along the z-axis, i.e. move
  602.  the topmost windows behind all other windows. The Push by: button
  603.  sets your favourite combination of mouse and keyboard event to
  604.  start the operation.
  605.  
  606.  Note:
  607.  The options not mentioned here do not work yet.
  608.  
  609.  Text controls
  610.  The only working option, at the moment is the Entry field
  611.  automatic text selection . This allows to select the whole
  612.  contents of any entryfield at once.
  613.  The Select by: button sets your favourite combination of mouse
  614.  and keyboard event to perform the operation.
  615.  
  616.  VIO windows
  617.  No options is working yet.
  618.  
  619.  Mouse
  620.  The options of this page are related to the mouse events.
  621.  
  622.  Automatic focus
  623.  the window (desktop child), under the mouse pointer is
  624.  automatically made active. The Delay spinbox allows to set how
  625.  long the mouse must stay on a window before it becomes the active
  626.  window. This option work for seamless WinOS2 windows as well.
  627.  Ignore desktop
  628.  when checked the desktop window is not made active when the mouse
  629.  pointer moves on it.
  630.  Don't bring to top
  631.  the activated window is not made the topmost window. This feature
  632.  is disabled when moving to or from a seamless WinOS2 window.
  633.  Ignore new windows
  634.  the autofocus feature is suspendend when a new window is opened
  635.  and is re-enabled only after the mouse has been moved on the new
  636.  window.
  637.  Pointer hiding
  638.  the pointer is hidden when it stop moving. The Delay spinbox
  639.  allow to set how long it must be still before it is hidden.
  640.  Exclude buttons
  641.  disables pointer hiding when it is over a button.
  642.  Exclude menu
  643.  disables pointer hiding when it is over a menu.
  644.  Remap button 3 click as button 1 double click
  645.  works with most PM windows and applications but still works
  646.  randomly with seamless WinOS2 windows.
  647.  Move the mouse pointer to the focus window
  648.  This group of features allows to automatically move the mouse
  649.  pointer to the window which gets the focus. It still doesn't
  650.  always work correctly. The two sub-options: Only on window
  651.  creation and Only on dialog windows work with an OR logic.
  652.  
  653.  The mouse/keyboard functions dialog
  654.  This dialog is present both as a notebook page and as an
  655.  independent dialog window which will popup every time you click
  656.  on a button to select the keyboard or mouse event to perform a
  657.  given feature (for instance the Mouse and Keyboard buttons of the
  658.  Window rolling page).
  659.  As an indipendent Dialog it has the ordinary OK , Cancel and Help
  660.  buttons to dismiss the dialog.
  661.  Its purpose is to give the user a sort of summary of all the
  662.  mouse and keyboard event which have been selected.
  663.  It is not yet so useful since most of the listed features have
  664.  not yet been implemented.
  665.  
  666.  The Function: list box shows all the features (that will be)
  667.  available.
  668.  The statusbar shows the control which should detect the chosen
  669.  mouse/keyboard event.
  670.  The checkbox Enable is disabled when a given feature has another
  671.  Enable checkbox in its own page.
  672.  When the radiobuttons Click and Double click are not visible the
  673.  selected mouse button event means which mouse button is held down
  674.  (like in the Frame drag feature).
  675.  Ctrl , Alt and Shift are additional keyboard keys which may be
  676.  associated with a mouse event.
  677.  
  678.  The Keyboard Mappings page (and the Functions controlled by the
  679.  keyboard dialog) allows to associate a function key (F1-F12) plus
  680.  Insert , Delete and Backspace with one of the modifier keys (Ctrl
  681.  , Alt and Shift ).
  682.  Since the keyboard accelerators have not yet been implemented it
  683.  is of no use at the moment.
  684.  
  685.  
  686. Known problems
  687.  
  688.    * When you suspect that a particular program conflicts with Smart
  689.      Windows add its name (including its full path) to the General
  690.      exceptions page, close the program (if it is still open) and restart
  691.      it. This usually works better than disabling Smart Windows.
  692.    * Do not use conflicting options when using other PM enhancers like Xit,
  693.      NPS WPS Enhancer, Program Commander/2, Object Desktop, etc.
  694.    * The MPTS configuration program doesn't work properly with Smart
  695.      Windows. The window controls (rolling, close, ecc) which are added by
  696.      Smart Windows seem to be the cause of the problem.
  697.      To solve this problem and let the program work properly add MPTN.EXE
  698.      (including the full path) to the list of the general exceptions or to
  699.      the list of the exceptions of the features which are the cause of the
  700.      problem:
  701.        1. titlebar exceptions (if you are using the titlebar enhancements)
  702.        2. titlebar hiding exceptions (only if you added the hide-titlebar
  703.           button to the window controls)
  704.        3. window rolling (only if you added the roll-windows button).
  705.    * Sometimes (it happened only a couple of times here) and for no
  706.      appearent reason, one of the mouse pointer in the current set, (for
  707.      instance the size NS pointer) get corrupted. To get rid of the
  708.      corrupted bitmap, open the Mouse object in the System setup folder,
  709.      select a different set of pointers and than restore the previous one
  710.      through the Undo button.
  711.    * The View caption (i.e. Icon view, Tree, etc) is missing from the
  712.      folders titlebar.
  713.    * The titlebar enhancements work only with real titlebars (FID_TITLEBAR
  714.      windows) so you get the default titlebar look inside Pro-News.
  715.    * PMview use its own procedure to paint the titlebar. I can anyway force
  716.      the application to use Smart Windows painting procedure, just did not
  717.      have time to try yet.
  718.    * Some users reported that moving windows by dragging the titlebar not
  719.      always worked when Smart Windows was installed along with object
  720.      desktop. I modified the mouse events detection procedure and the
  721.      problem should have been reduced if not completely eliminated. Another
  722.      user suggested to eliminate an object desktop DLL from the list of the
  723.      DLLs which are loaded during system startup.
  724.      If you have Warp4 and installed fixpack 5 or a later one, you have in
  725.      your \OS2\SYSTEM directory the program REGEDIT2.EXE, if you cannot
  726.      find it you can find various free INI file editors in the hobbes
  727.      server. You must edit your OS2.INI file often defined as user profile
  728.      , or HINI_USER_PROFILE in REGEDIT2.EXE and look for the SYS_DLLS item
  729.      and its LoadPerProcess sub-item.
  730.      This sub-item contains a list of DLL names (not including the path and
  731.      the DLL extensions) separated by a space. To remove the object desktop
  732.      DLL from the list, delete the OBJDWCTL string, save the new INI file
  733.      and reboot.
  734.      If the system works better this way and you are not missing any of
  735.      your favourite object desktop features just leave it this way. If you
  736.      want to restore its previous state just add the OBJDWCTL string to the
  737.      list. You could also try to change the order in the list by putting
  738.      SMARTWIN before OBJDWCTL.
  739.      I do not own any version of object desktop and am not planning to buy
  740.      it just to make few tests, so I would be grateful if you let me know
  741.      your experiences with the above described modifications. If it works I
  742.      could make a small application (and/or add a setting in the
  743.      SmartWindows preferences notebook) to automatically remove, restore or
  744.      change the order of the Object Desktop DLL in the list in OS2.INI.
  745.    * Window rolling does not work properly with some programs (AICQ, MED).
  746.    * An user reported that in Warp 3 the color selection buttons do not
  747.      work when the mouse is setup for left-handed use. I unsuccesfully
  748.      tried to replicate the problem in a Warp 3 partition (refresh release
  749.      - no fixpack) so I guess it is some bugs from one of the most recent
  750.      fixpaks.
  751.    * Window controls in Watch Cat do not work properly.
  752.    * Various problems with Describe, OpenChat/2.
  753.  
  754.  
  755. Planned features
  756.  
  757. The first planned feature is a registrable version. Since the next
  758. registrable version I'll remove the time expiration and replace it with
  759. some other kind limitation for not registered users.
  760. Other planned features (I do not grant that all of them will be in version
  761. 1.0) are:
  762.  
  763.    * A better Disable feature.
  764.    * A better installer (should allow to install patches and Smart Windows
  765.      themes).
  766.    * The color and bitmap dialogs in the preferences notebook should update
  767.      the titlebar sample as soon as a new color or bitmap has been selected
  768.      with no need to dismiss the dialog.
  769.    * Mouse buttons combinations (like mouse button 1 and 2 or 2 and 3,
  770.      etc.) should be added in the list of selectable events.
  771.    * Implementation of keyboard shortcuts for the various features.
  772.    * Some more items like (Roll/unroll all windows, Hide/unhide all
  773.      windows, Disable Smart Windows, etc. should be added to the desktop
  774.      menu)
  775.    * Bitmapped backgrounds for dialog windows.
  776.    * Force all dialogs to be displayed above or below a given area of the
  777.      screen (did you ever notice how boring it is when you want to click on
  778.      some dialog buttons and the WarpCenter comes to the top?).
  779.    * Dinamically change the layout of dialog windows (size and position of
  780.      controls, text displayed, font, colors, etc.).
  781.    * Mouse click drop.down for entry fields part of combo-boxes.
  782.    * Better exceptions dialogs and better detections of the programs to
  783.      exclude.
  784.    * Popup menu and mouse actions in text controls for clipboard
  785.      operations.
  786.    * Automatic selection for menu.
  787.    * More options for autofocus and moving the mouse pointer to the focus
  788.      window.
  789.    * Automatic reset of mouse pointers sets when DIVE applications are
  790.      started and closed.
  791.    * New look for scrollbars, buttons, radiobuttons, checkboxes, etc.
  792.    * More titlebar styles.
  793.    * Complete control on the various colors of the PM components (this will
  794.      be available only with Warp 4 unless the newer Warp 3 fixpacks made
  795.      some new API available).
  796.    * Import/export of Smart Windows configuration schemes.
  797.  
  798. Registration
  799.  
  800. Please be patient. I'll make the registrable version available as soon as
  801. possible.
  802.  
  803.                    --------------------------------------
  804.  
  805. Alessandro Cantatore
  806.