jbWheel readme.txt - version 0.90, 4/5/2001 ------------------------------------------------------------------------------ DESCRIPTION: jbWheel is an OpenTool that enables WheelMouse in JBuilder. This tool uses a native Windows DLL library; it won't work under other systems. WARRANTY AND TERMS OF USE: This software is freeware. You can use both binary code and sources (non-commercially) in any way you like. This software is provided "as is" with no warranty of any kind. I take no responsibility for any damages that may result from using it. In such cases, blame yourself. FILES: The software is packed inside jbWheel.zip file. The following files should be inside the archive: -JAR file with compiled classes (jbWheel.jar) -DLL library (jbWheel.dll) -ZIP file with source code (jbWheel.src.zip) -readme.txt (the file you enjoy reading at the moment) INSTALLATION: Unpack files from jbWheel.zip archive and put them in the following places: - the JAR file (jbWheel.jar) in \lib\ext directory - DLL file (jbWheel.dll) in \lib\ext directory or in any directory that is included in your "java.library.path" variable. "C:\Windows" or any other directory from your system PATH variable will probably be a good place. Start JBuilder. There should be a new item under the "Tools" menu for configuring the mouse. You should be able to use the wheel now. HARDWARE AND SOFTWARE TESTED: -MS IntelliMouse (MS drivers and IBM Mouse Suite) -Logitech wheel mouse (Logitech drivers) -A4 wheel mouse (MS drivers) -IBM ScrollPoint mouse (with IBM Mouse Suite); I tested the tool only with JBuilder 4.0 (pro & foundation). =============================================================================== HISTORY OF CHANGES: VERSION 0.90: -Reverse scrolling direction now can be applied to each action separately (users request). VERSION 0.89: -I finally managed to reproduce the problem with the wheel not working after switching to and from JBuilder. It looks like on Win2000 my hook procedure is kicked out of the hook chain after some time (I'm not sure: unfortunatelly I don't remember to much about Windows programming). DLL is rewritten to part use hooks only for discovering newly opened windows. The problem might not be completly gone but should occur less frequently. -Bugfix: scrolling designer windows should work better now. VERSION 0.88: -The DLL now intercepts not only messages *posted* but also *sent* to the application. As a result IBM ScrollPoint mice are now supported. Please note that the tool uses WM_MOUSEWHEEL messages, so horizontal scrolling with ScrollPoint mice doesn't work (it's doable but since JDK 1.4 will be available any minute, I don't want to spend too much time on solving it). -New option with strange name "Try to scroll in both directions" added. It provides functionality similar to some standard Windows windows: if a given component has no vertical scrollbar the tool tries to scroll it horizontally. -Version resource added to DLL. -Bugfix: some users noticed that jbWheel 0.85 fails to initialize. This happens whan java.path contains an inaccessible (or broken) library. The solution comes from Valentino Kyriakides. Thanks! -Bugfix: scrolling window by page (i.e., using Ctrl+Wheel) in help windows worked only in the Up direction. The fix was provided by Ricardo Correia Marques. Thanks! -Bugfix: scrolling slider controls with no tick marks should work ok now. -Bugfix: components inside titled borders are scrolled properly (code to find component at cursor replaced with a function provided by SwingUtilities). VERSION 0.86 & 0.86: -More traces. VERSION 0.85: -Scrolling in context Help windows added. VERSION 0.8: -Scrolling in Help windows added. It works in "regular" help windows (launched from the Help menu) and in "Doc" tabs in editor. Unfortunately it doesn't work in context Help windows (launched by pressing F1 key) - I'm not able to get handle to such window. The fix for scrolling "Doc" tabs goes from MVC who got frustrated of not being able to scroll diagrams in his $6K Together Enterprise and adopted my jbWheel code for it. Thanks MVC! VERSION 0.7: -Added workaround for the problem with scrolling not working properly in JB4 (BTW: it looks like a bug in JBuilder's TabbedContentManager). VERSION 0.65: -Because of all the messages I received asking, "where the hell should I put the DLL" I changed default behavior to load it also from the same directory as the JAR file (i.e., from \lib\ext). VERSION 0.6: -Seems to work under systems with no WM_MOUSEWHEEL message supported (i.e., under Windows 95 and some Windows 98 versions). -Default scrolling mode is now "component under cursor". -The way of adding dialog to JBuilder menu fixed (for some reason JBuilderMenu class is not documented in OpenTools javadoc). It should work now in case of localized international JBuilder versions (if there are any). VERSION 0.5: -Seems to work now in JDK 1.3. -Scrolling in JSlider and in non-editable JComboBoxes added. -Options dialog allows to map keys to actions. VERSION 0.2: -"Scroll component at cursor" mode now works. -Horizontal scrolling when mouse pointer placed over horizontal scrollbar ("component at cursor" mode only). -Scrolling now partially works in Help windows ("component at cursor" mode only + mouse pointer must be over the scrollbar). -Scrolling works in popup windows (dialogs). =============================================================================== MISSING FEATURES & BUGS: -MemberInsight listboxes cannot be scrolled. CONTACT: If you have any questions or you encounter problems using this software, contact me at: mailto:czerwony.kapturek@wp.pl I can't promise to answer all messages, but I'll do my best. For the newest version of the software, check: http://CzerwonyKapturek.tripod.com CREDITS: This software has been developed using great free tools from Borland: C++ compiler ver. 5.5 and JBuilder Foundation 3.5 and 4.0. The code for scrolling "Doc" tabs comes from MVC. Thanks!