Tk/JComboBox version 1.12 ========================= CHANGES OVERVIEW: (details below) Maintenance release to correct various minor bugs and annoyances. OVERVIEW: JComboBox is a Combo Box implementation that combines several features of the various Combo Box implementations available for Perl/Tk and attempts to provide a solution that should cover the majority of your Combo Box needs. The implementation tends to skew somewhat towards the Java and Win32 implementation of a Combo Box more than the Motif one. TEST SUITE: I've spent the majority of the time writing a fairly robust test suite, though there are still a few gaps which are being worked on. A considerable amount of effort has gone into verifying that the unit tests will work on multiple platforms, though I suspect that there may yet be a problem or two remaining (mostly regarding event generation (which seems to be a bit tempermental) and tests that use fonts. I suspect that many of the reported failures I see have more to do with a bad installation of Tk than JComboBox, but your mileage may vary. The tests mostly serve as a tool for me for regression testing, and for anyone else who decides to tinker with the source. I'm always interested in hearing ways in which the test suite can be improved. Thanks to everyone who has contributed suggestions, code, and any other feedback. I'm not always able to incorporate that feedback, but I've always found it to be helpful. I hope this widget continues to be useful. CHANGES for 1.12 RELEASE: (Full Change history in Changes file) 1.12 Maintenance/Bug Fixes: This is a maintenance release of Tk-JComboBox that addresses an issue with the -popupcreate callback option. In addition, I've updated some test cases, added an examples directory, and updated some of the Pod files. There is a potential backward compatibility issue with this release (the -popupcreate option), but there is no major new functionality (At least one new option may be coming in the next release...) - Issue: jdtoronto posted a bug report on the Perlmonks site. http://perlmonks.org/?node_id=573624. He was attempting to use the popupcreate option to modify the JComboBox each time the Popup was triggered. In version 1.11 and for at least the past few versions, registering a callback to this option meant that you were assuming responsibility for configuring the height/width and positioning of the JCombobox, which can be a pain. -- Resolution: I decided that this was too big a pain to pass on to users, and modified the option so that the physical configuration occurs outside of this callback. -popupmodify can still be used to override the layout properties if needed. The result is that popupcreate is simpler to implement (it was mostly provided as a means to alter the list item contents of the JComboBox). Documentation, and test cases were adjusted accordingly, plus an example was provided in the new examples directory that demonstrates the option in action. - After conversation with Fred Jan, I reconsidered the implementation of the -textvariable option. JComboBox goes a bit further than some other widgets and heavily controls -textvariable use. I've decided to leave it as is for now, but to hold onto the correspondance and possibly revisit it in the future. No changes aside from a tweak to the docs. - Took another pass through the JComboBox docs to update several links that were incorrect, and fix some wording here and there. INSTALLATION To install this module type the following: perl Makefile.PL make make test make install DEPENDENCIES This module requires these other modules and libraries: Tk Tie::Array Tie::Watch Optional dependencies (for testing): Test::Pod COPYRIGHT AND LICENCE Copyright (C) 2001-2006 Rob Seegel (RobSeegel[at]comcast.net) This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.