Revision history for "ptkftp". 4.31 Aug/2002 - Complete redesign from older version. - Started recording Changes. 4.4 Fri Aug 16, 2002 - Fixed bug where "-browsecmd" callback was called too often. - Fixed bug where "end" was added as a value on listboxes with no "-width" option specified when list was automatically resized. - Fixed problem where listbox width not automatically resized down to new entry field width when it became smaller. - Added code to cause the dropdown button and list to be disabled whenever the list size becomes zero and reactivate whenever a choice is added to a zero-length list. - Fixed minor bugs with "choices" and "insert" function. - Added this Changes file 4.41 Sat Aug 17, 2002 - Fixed disabled background color on entry text. 4.42 - Added "-maxwidth" option to limit maximum width in characters the entry field will expand to. Otherwise, it can expand as list items are added to accomodate the widest item string. 4.43 May 31, 2003 - Added several patches by Frank Herrmann to cause the "-browsecmd" callback to be called whenever the text value changed, and some other minor tweeks. 4.44 - Added "-listrelief" option to allow one to specify the relief of the dropdown list (defaults to "sunken" and was previously always "sunken"). - Added "-browse" option to allow for old "-browsecmd" callback behavior so that it is only called when a selection is actually made from the dropdown list. This was the behavior before the "Frank Herrmann" patches were added. The default is the new behavior. To get the old behavior, use "-browse => 1". 4.47 Thu Nov 20, 2003 - Added "-tabcomplete" option to allow pressing the "<Tab>" key in the Entry widget to cause an incomplete string typed in to be "completed" to the next matching string in the list. Pressing the "<Tab>" key again will transfer focus to the next widget. To get this behavior, use "-tabcomplete => 1". The default is the old behavior of simply tabbing to the next widget without altering the typed text. 4.48 Fri Nov 21, 2003 - Fixed bug which caused tab-key to be "stuck" on the widget if there was nothing in the listbox. Made "-tabcomplete" not change what user typed in if there is no match in the list. Added "-tabcomplete => 2" to keep 4.47 behavior (force tab to change the typed value to a valid list entry or the default value). 4.49 -not released. 4.50 Fri Nov 28, 2003 - Minor tweeks in relief appearance. 4.52 Tue Feb 01, 2005 - Added "-altbinding" option to allow different keyboard binding schemata. - Added "-disabledbackground" and "-disabledforeground" options. - Fixed "-labelPack" option to work, if packed above or below main widget. - Fixed small glitch in listbox vertical sizing. 4.61 Mon Feb 14, 2005 - Added hash-reference as an option for the choices so that it can work like selects in HTML where one set of values is displyed to the user (the hash values and the other (the keys) is actually returned. Also added the functions: dereference, dereferenceOnly, hasreference, and fetchhash to work with these. 4.63 Apr 29, 2006 - Added option (-deleteitemsok) so that user can delete items from history list. 4.64 Sun Jul 30, 2006 - Minor tweeks for JFileDialog. 4.65 Tue Oct 25, 2006 - Add right-arrow completion so that if one types the first (few) letter(s) of one of the choices in the list, then presses the right-arrow (with the cursor at the end of the typed string, the text will be completed with the first matching choice in the list (similar to up and down-arrow, but repeated pressing only toggles between any matching choices in the list, whereas down-arrow, continues to switch between all the choices in the list. To revert to pre-4.65 behavior, specify -altbinding => 'Right=NoSearch'. 4.70 Mon Sep 24, 2006 - Added new options: -framehighlightthickness (default 1), -buttonborderwidth (default 1), and --entryborderwidth (default 0). - Changed initialization of -borderwidth and -buttonborderwidth to fix inconsistancies pointed out by Wolfram Humann. - Fixed activation issue on up and down arrow presses and with "back- tab with patch from Wolfram Humann. Thanks for the patches! - Fixed other minor issues. - Fixed makefile using new version by Alexandr Ciornii that, among other things, fixes the bug that caused the manpage file to have an extra TK:: prefix appended to it. 4.71 - Added "-listcmd" callback. - Added "-nobutton" option to prevent dropdown list button from being displayed (default 0 (false)). - Added "-labelrelief" option (default "flat"). - Added invocation of the "-browsecmd" callback if <Return> is pressed in the text field and -altbinding includes "Return=Go". - Added a "NoListbox" altbinding to cause the "-browsecmd" callback to NOT be invoked for specified altbindings, ie. "NoListbox=listbox.space" causes the callback to not be executed if the <spacebar> is pressed while the listbox has keyboard focus. 4.72 - Added new user-callable function get(). get() with no arguments returns the current value of the "-textvariable" variable. If any arguments are passed, they are passed directly to the listbox->get() function, ie. "0", "end" to return all values of the listbox. - Added new user-callable function activate(). activate() invokes the activate() option on the listbox to make the item with the index specified by the first argument "active". Unless a second argument is passed containing a false value, the value of the "-textvariable" variable is also set to this now active value. - Added new user-callable function index(), which invokes and returns the result of the listbox index() function. - Added new user-callable function size(), which invokes and returns the result of the listbox size() function (the number of items in the list. - Fixed possible bug with the return results from the choices() function when called without any arguments. 4.73 - Fixed so that whenever the mouse is clicked or the spacebar pressed within the text area and the text area is readonly and either empty or does not contain text that matches any of the items in the dropdown list, then the 1st item is activated and highlighted instead of the last one. 4.74 - Fixed so that whenever the "-textvariable" variable is undefined, then the dropdown list is shown, the 1st item will be activated and highlighted instead of the last one. 4.75 - Remove accidental reference to DBI in test file (fix broken test) This closes rt.cpan.org bug#50767. 4.8 - Use of a hash for the choices list was broken - hash was reversed within the insert() function so that fetchhash() returned a hash that was the opposite of what was passed to choices. Renamed fetchhash() function to get_hashref_byname() - still returns the reversed hash, and fetchhash() remains in place for backwards compat. Added new function get_hashref_byvalue() to return the hash back out correctly! Also added new functions: get_index('value') to return the index# (usable by get() function of the list option displayed as 'value'); delete_byvalue('value' [, 'value2'...]) to delete list items by their displayed values; and reference() to return the displayed list value for the given hash key (opposite of dereference()). 4.9 - Add new callback option when user deletes an entry from the drop-down menu with the [Delete] key, as permitted by the "-deleteok" option. The new callback option is "-deletecmd" which invokes a user-defined function just before and again just after a menu entry is deleted. This was needed in order to update arrays in the main program that are loaded and saved in "history" files in order to know when the valid list choices had changed and apply them properly. The first call receives the entry index# (>0) being deleted, and can return true if the deletion needs to be blocked, false or undef otherwise. This permits the programmer to block user-deletes, ie. for certain entries, etc. The subsequent call (with the parameter of -1), occurs just after the deletion (if the first call did not return true) & can be used to do something after a deletion has actually occured, ie. as explained above. 5.0 - * Fixed issues involving the -arrowimage / -farrowimage options not always working properly, particularly on M$-Windows. * Added new PressButton() function to enable developers to programattically "press" the dropdown list button. * Added new get_icursor() function to make fetching the cursor location in the entry field. Most useful arguments are: 'insert' and 'end'. * Added -deletecmd callback to allow user to properly update their history files when feeding them to the drop-down list. * Added -altbinding options: "Return=NoEmptyGo", "Return=SingleGo", and "Down=Popup" as well as "Down=None", "Up=None", "Right=None", "Esc=None", "Return=None", and "Space=None". * Adjusted dropdown menu's width to work better when -nobutton is set. * Cleaned up the code and documentation, including fixing some "strict refs" errors and problems when a -default value is specified.